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PREFACE 


The CONTROL DATA® Transaction Facility (TAF), 
Version 1.3, is a network host product. It is a 
network application that requires the facilities of 
the Network Access Method (NAM) and the 255x Series 
Communications Control Program (CCP). TAF runs as a 
subsystem of the Network Operating System (NOS), 
Version 2, and may be used with COMPASS, FORTRAN, or 
COBOL. 

This manual documents the executive portion of TAF. 
The three data managers available for use with TAF 
are each documented in their respective reference 
manuals. These are: 

• CDC® CYBER Database Control System, Version 
2 (CDCS) 

• CDC TAF/CRM Data Manager Version 1 (CRM) 

• CDC TOTAL Data Manager Version 2 

Refer to the list of related publications for full 
titles and publication numbers of the respective 
manuals. 


AUDIENCE 

This manual is for the data administrator and 
applications programmer. The data administrator 
(DA) is a person or a group of people responsible 
for installing and maintaining the transaction 
subsystem. This person or group sets up the data 
base and describes the relationships among the 
various elements. The DA is concerned with the 
internal design of the system and can modify many of 
the system components to suit site requirements* An 
applications programmer is a person who writes tasks 
in FORTRAN, COBOL, or COMPASS to be used by the end 
user (terminal operator). Using these tasks, the 
terminal operator can access and update the data 
base with little or no knowledge of TAF. New users 
of TAF should consult the TAF I User's Guide as a 
first source of information* It is an introductory 
text for inexperienced users. 

The user must be familiar with basic NOS operations 
such as running a compilation Job* The NOS 2 
Reference Set, Volume 2, acquaints the new user with 
the fundamentals of NOS. The NOS 2 Reference Set, 
Volume 3, is for the high-level language applications 
programmer who is already familiar with NOS. The 
NOS 2 Reference Set, Volume 4, is for the COMPASS 
applications programmer. 


TERMINOLOGY AND CONVENTIONS 

References in this manual to the transaction 
subsystem imply every aspect of TAF. References to 


the transaction executive imply the controlling 
portion of TAF, the portion described in this 
manual* References to FORTRAN imply either FORTRAN 
Extended Version 4 or FORTRAN Version 5; TS mode is 
not allowed (that is, the SEQ, TS, and OPT»0 
parameters are not allowed on the FTN command). 
References to COBOL imply Version 3. 

Where brackets, [ ], are used in task request format 
descriptions, they indicate optional parameters. 

The term alphanumeric refers to any combination of 
the letters A through Z and the numbers zero through 
nine; special characters are not included. 


Conventions for word formats are as follows: 

• Crosshatching indicates a field is not used 
by or is not applicable to TAF, 

• Reserved fields may contain information 
useful to TAF internal processing. The user 
should not expect them to contain any partic¬ 
ular values. 

• Fields labeled with mnemonics indicate that 
a specific parameter must be inserted (gener¬ 
ally described after the word format). 

• Fields with numeric identifiers indicate the 
actual value that is used or returned for a 
particular request. 

Models 815, 825, 835, 845, and 855 of the CYBER 170 
Computer Systems share many of the functional and 
architectural attributes of the CYBER 180 computer 
systems (models 810, 830, 835, 840, 845, 850, 855, 
and 860). The term CYBER ISO-class machines de¬ 
scribes these similar models collectively* 

Extended memory for model 176 is large central 
memory extended (LCME). Extended memory for models 
865, 875 and CYBER 180-class machines is unified 

extended memory (UEM). Extended memory for models 
865 and 875 may also include either extended core 
storage (ECS) or extended semiconductor memory 
(ESM). Extended memory for all other NOS computer 
systems is either ECS or ESM. ECS and ESM are the 
only forms of extended memory that can be shared in 
*a linked shared device multimainframe complex and 
can be accessed by a distributed data path (DDP). 

In this manual, extended memory refers to all forms 
of extended memory unless otherwise noted. 

Programming Information for the various forms of 
extended memory can be found in the COMPASS 3 
Reference Manual and in the appropriate computer 
system hardware reference manual. 
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RELATED PUBLICATIONS 


Control Data Publication 

Publication 


Number 

The following manuals contain additional information 



for the user* 

Publication 

NOS Version 2 Reference Set, 
Volume 2, Guide to System Usage 

60459670 

Control Data Publication 

Number 

NOS Version 2 Reference Set, 

60459680 



Volume 3, System Commands 

COBOL Version 5 Reference Manual 

60497100 

NOS Version 2 Reference Set, 


Common Memory Manager Version 1 
Reference Manual 

60499200 
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NOS Version 2 Administration 


COMPASS Version 3 Reference 

Manual 

60492600 

Handbook 
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Version 2 Data Administration 


TAF Version 1 User's Guide 

60459520 

Reference Manual 
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CYBER Database Control System 
Version 2 Application Program¬ 


Version 1 Reference Manual 

60459510 

ming Reference Manual 

60485300 

TOTAL - CDC Version 2 

Reference Manual 
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CYBER Loader Version 1 

Eleference Manual 60429800 

FORTRAN Extended Version 4 

Reference Manual 60497800 


FORTRAN Version 5 Reference 

Manual 60481300 


Network Products Network Access 
Method Version I Network Defini¬ 
tion Language Reference Manual 60480000 


The NOS 2 Manual Abstracts is a pocket-sized manual 
containing brief descriptions of the contents and 
intended audience of all NOS and NOS product manuals* 
The abstracts can be useful in determining the 
manuals of greatest interest to a particular user* 

Control Data also publishes a Software Publications 
Release History, publication number 60481000, of all 
software manuals and revisions packets it has issued* 
This history lists the revision level of a particular 
manual that corresponds to the level of software 
installed at the site* 


Network Products 
Network Access Method Version 1/ 
Communications Control Program 
Version 3 Host Applicaton 

Programming Reference Manual 60499300 


These manuals are available through Control Data 
sales offices or Control Data Literature Distribution 
Services (308 North Dale, St* Paul, Minnesota 35103)* 


NOS Version 2 Network Terminal 

User's Instant 60439380 SUBMITTING COMMENTS 


NOS Version 2 Installation 

Handbook 60459320 

NOS Version 2 Manual Abstracts 60483500 


NOS Version 2 Operations 

Handbook 60439310 

CYBER Record Manager Advanced 
Access Methods Version 2 

Reference Manual 60499300 

CYBER Record Manager Basic 
Access Methods Version 1*5 
Reference Manual 60495700 


Network Products 

Network Access Methods Version 1/ 
Communications Control Program 
Version 3 Terminal Interfaces 
Reference Manual 60480600 

NOS Version 2 Reference Set, 

Volume 1, Introduction to 

Interactive Usage 60459660 


The last page of this manual is a comment sheet* 
Please use it to give your opinion on the manual's 
usablility, to suggest specific improvements, and to 
report any errors* If the comment sheet has already 
been used, you can mail you comments to: 

Control Data Corporation 
Publications and Graphics Division ARH219 
4201 Lexington Avenue North 
St* Paul, MN 55112 

Additionally, *if you have access to SOLVER, an 
online facility for reporting problems, you can use 
it to submit comments about the manual* Declare 
your problem type as DOC and use NS2 as the product 
identifier* 


DISCUIMER 

This product is intended for use only as described in 
this document. Control Data cannot be responsible 
for the proper functioning of undescribed features 
or parameters* 
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INTRODUCTION 
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TAF is a network product that controls transaction 
processing. Transaction processing consists of 
taking an existing collection of Information, called 
a data base, and correcting old data or adding new 
data to create an up-to-date data base. Such a 
correction or addition Is called a transaction. 

In a transaction processing system, the data base 
must be efficiently structured and easily accessible 
to the user. A data manager provides these features. 

Control Data offers the following data managers for 
use with TAF. 

• The CYBER Database Control System (CDCS). 

• The CYBER Record Manager (CRM). (TAF 
supports only those features documented in 
the TAF/CBM Data Manager 1 Reference Manual.) 

• The TOTAL Data Manager. 

All data managers can operate concurrently. 
However, a single transaction can use only: 

• CDCS and one other data manager, 

or 

• CDCS alone, 

or 

• One other data manager alone. 

The main function of TAF Is on-line transaction 
processing; that is, direct 'operator interface with 
the data base through a terminal. 


ON-LINE TRANSACTION PROCESSING 
ADVANTAGES 

Some advantages associated with on-line transaction 
processing are: 

• The operator submitting the data through TAF 
can make immediate data corrections. 

• The operator can verify that operations have 
completed successfully. TAF allows the 
operator to view additions or corrections to 
the data base to verify their accuracy. 

• The data base is updated In seconds. TAF 
provides immediate updating capability, 
which allows other transactions to make use 
of the updated data base. 


The most Important feature of TAF is Its efficient 
system resource utilization. TAF's transaction 
processing differs from other modes of operation in 
that a task only contains application code. 
Terminal communications are handled by one terminal 
communications Interface. Data base communications 
are handled by one copy of a data base manager. 
When tasks need to be loaded, they are simply copied 
from a task library to a subcontrol point; none of 
the normal overhead of loading is Incurred. 

The TAF control point contains application tasks as 
subcontrol points. When a task completes, one of 
the following occurs: 

• It may be Immediately reused by other 
waiting transactions (no reloading Is 
necessary). 

• Another task may be loaded In Its place. 

• Other active tasks may be moved up In memory 
and the remaining memory returned to the 
system for use by non-TAF applications. 

TAF will expand its memory to a maximum value as 
needed. 

When there is no transaction activity, TAF size is 

reduced to a small amount of memory. When Input is 
sensed, TAF rolls back in to service the request. 

Figures 1-1, 1-2, and 1-3 summarize the TAF control 
point and its operation. 

ON-UNE TRANSACTION PROCESSING 
PROBLEMS 

Some problems associated with on-line transaction 
processing and the methods that TAF uses to 
alleviate them Include the following. 

• It Is difficult to schedule and control 

multiple jobs. TAF solves the problem of 
multiple job control scheduling by using 

subcontrol points. Like the operating 

system that controls and schedules jobs to 

control points (where they are processed), 
TAF controls and schedules transaction 
processing programs to portions of its 

control point called subcontrol points. 
Subcontrol points are protected from each 

other by CYBER hardware memory protection. 

• The terminal Interface is complicated. TAF 

minimizes terminal programming by using 

simple input/output (I/O) commands that are 
processed by the standard network terminal 
interface. 
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Figure I*-!* IVU? Control Point for CDCS Data Manager 



Figure 1-2. TAF Control Point for TAP/CRM Data Manager 
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Figure 1-3. TAP Control Point for TOTAL Data Manager 


BATCH INTERFACE 

A batch Interface with TAF is also available* The 
batch Interface can generate large reports without 
tying up a terminal until the listing has been 
printed. The report can be printed at a high-speed 
central site printer. Batch mode can also be used 
for testing and debugging. The batch interface is 
described in section 5. 


NETWORK INTERFACE 

The network terminal interface uses NAM and 255x 
cocmunlcations processors. This interface is used 
by all other network products (for example, Remote 
Batch Facility and Interactive Facility). If 
validated, terminal users may select these 
applications as well as TAF. The network provides 
the following features for transaction processing. 

• Managing network protocol. 

• Buffering and queuing data for regulating 
data flow. 

• Supporting a wide variety of terminals 
through standardization of data formats as 
well as providing the ability to handle 
transparent data. 

• Sharing network among communication-oriented 
services. 


The network makes use of the interactive virtual 
terminal (IVT) concept. This concept abstracts 
certain functions of a variety of real terminals. 
The applications programmer need not be concerned 
with character sets and communications protocols. 

• An IVT has an input/output device that sends 
or receives certain amounts of data termed 
logical lines* These logical lines are 
transformed into physical lines of characters 
of the appropriate character set for the 
real terminal. 

• Logical lines Chat exceed the physical 

capacity of the real terminal are 

automatically folded into two or more 

physical lines* 

• The spacing of logical lines of output can 
be further controlled by the use of format 
effectors. 

• CXitput Co a device may be optionally paged, 
so that data Chat would overwrite any output 
being displayed is not sent until Che 
terminal user has acknowledged the preceding 
output« 


• Both the application and the terminal user 
can redefine terminal characteristics of the 
actual terminal, which may differ from chose 
assumed, and supply or redefine the 
operational controls provided. 
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Whea an application requires features not provided 
by the IVT but known to exist on the connected real 
terminal, the application may do one of the 
following* 

• Embed appropriate control characters In the 
output text* 

• Transfer data in transparent mode, in which 

case all transforms are inhibited, and the 
application has direct access to and 

responsibility for all real terminal 

features including the character set* 


TASKS 

The applications programmer implements a transaction 
system by writing tasks* A task is a program with a 
TAF Interface that performs a specific function* k 
single task or several tasks perform a sequence of 
events called a transaction* Tasks can read and 
update information on the user^s data base. They 
can send messages to terminals and receive input* 
Tasks can also schedule other tasks to assist in 
completing transactions* 

Tasks that run under TAF can be written in COBOL, 
FORTRAN, or COMPASS. A task differs from a normal 
batch or interactive program in that it contains 
calls to TAF commands and data manager commands and 
must have a common block (referred to as the 
communication block) defined* The communication 
block is needed to receive terminal input and pass 
data between tasks* (The communication block is 
described in section 2«) 

Binary copies of each task are stored in the task 
library* The LIBTASK utility is used to place these 
binary copies on the task library* Section 10 
describes the task library and LIBTASK* 

I Tasks written in COBOL must be compiled with the TAF 
parameter on the COBOL command* Tasks written In 
FORTRAN must be compiled with the Z parameter on the 
FORTRAN command (FORTRAN 4) or with DB=*0 on the FTN5 
command (FORTRAN 5). 


TRANSACTION PROCESSING 

After following the login procedures outlined in 
appendix J, the user indicates the transaction to be 
performed by entering a code that is assigned by the 
system designers* Such a code could specify that a 
user is entering a loan payment; another code would 
be used to close out a loan, and so on* TAF receives 
this Initial Input and places It In a communication 
block* This communication block is the means by 
which the data is passed from a terminal to a task 
or from task to task* 

When a transaction is completed, the communication 
block Is released and can be used by other 
transactions* 


After the communication block has been constructed, 
TAF schedules an initial task (ITASK) to interpret 
the code the user entered* Using this code, ITASK 
requests TAF to schedule the appropriate task(s) to 
process the transaction* The task scheduled may 
also call other tasks to assist in completing the 
transaction* 


TAP REQUESTS 

Communication between terminals and tasks is 
accomplished by using TAF requests* Output can be 
sent to a transaction terminal from the task by 
using the SEND request* When this request is 
processed, control passes to TAF* TAF extracts the 
message from the task and passes it to the network* 
The message is then transmitted to the transaction 
terminal, and control passes back to the task for 
additional processing* 


When a task requires additional input from the 
terminal, the WAITINP request Is used* The task 
performs a SEND request to send output to the 
terminal, prompting the terminal operator for the 
needed Input* The WAITINP request is then 
processed* Since the terminal operator takes 
seconds to respond to the request, the task Is 
rolled out of central memory and the subcontrol 
point and communication block are released* These 
resources can then be used to process other 
transactions while the terminal operator is 
responding* When TAF receives the requested input, 
it places it into a new communication block, and the 
task is rolled into an available subconcrol point * 
The new communication block is passed to the task, 
and the task continues processing* 

These and ocher requests are further described In 
sections 2 and 5* 


ENTERING THE TRANSACTION SUBSYSTEM 

The subsystem you will be accessing Is the TAF 
subsystem* There are various procedures for 
accessing this transaction subsystem* These methods 
are discussed in detail in appendix J* Using 
appendix J, a coordinator of TAF activities at a 
particular site who knows the types of users and 
applications at the site can determine Che most 
desirable access procedures* 

Because of the flexibility of the network and the 
transaction subsystem, the procedure to access the 
transaction subsystem can vary substantially from 
site to site* Therefore, the coordinator of 
transaction subsystem operations at each site should 
provide each user, or terminal location, with a 
detailed login procedure for that site* 

The site should also provide Information concerning 
terminal characteristics* A variety of terminal 
classes Is supported for use on the network with 
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Each of chese terminal classes has character¬ 
istics, which Che analyst can change by modifying the 
network files and which you can change by entering 
terminal definition commands* 

A discussion of the terminal characteristics, the 
defaults for each terminal class, and the procedure 
for changing these characteristics at a terminal is 
included in appendix G* 

IMPLEMENTING AN APPLICATION 

The following steps specify the procedure for 

implementing an application* 

1* Review this manual* 

2* Design the application including: 

• Selection of the data manager (CDCS 
and/or CRM, or TOTAL) to allow the 
correct choice of file types, file 
structure, and file interaction* 

• Selection of recovery and backup 
techniques, including journalizing 
of files* 

Refer to the CYBER Database Control System 2 
Reference Manuals, the TAF/CRM Data Manager 
1 Reference Manual, or the TOTAL - CDC 2 
Reference Manual for more information (publi¬ 
cation numbers are listed In the preface). 

3* Describe and Install the data base using the 
data manager* Refer to the appropriate data 
manager reference manual for this procedure* 

4* Test load the data base using the data 

manager commands (usually done in batch 
mode)* 

5* Dsing the application design, write the 

application tasks to process transaction 
Input * 

6* Optionally modify XTASK to reflect the 

actual application* Tasks MSABT, L06T, and 
SYSMSG may also require modification* 
(Refer to section 11*) 

7* Build a task library* (Refer to section 10*) 

8* Build an xxJ file* (Refer to section 4*) 

9* Build a network file, and use MDL to 

configure terminals and establish login 
sequences and terminal characteristics* 

10* Build the TAP configuration file (TCF)* 

(Refer to section 4*) 

11* Test the system* 

SUBCONTROL POINTS 

The following discussion Is intended for analysts 
and may be omitted by the applications programmer* 


Tasks reside at subcontrol points within the field 
length of the transaction executive* Each task runs | 
with Its own exchange package, reference address 
(relative to the transaction executive), and field 
length (a subset of the field length of the trans¬ 
action executive)* A task, therefore, can reside in 
any contiguous segment within the transaction execu¬ 
tive field length* Memory is allocated in lOOg 
word blocks located on even lOOg word boundaries 
(for example, 32 IOO 3 to 32200$)* A subcontrol 
point consists of one 120$ word block of memory 
for system use, followed by sufficient blocks to 
contain an entire task* 

The subcontrol point feature allows the transaction 
executive to control each task* Some of the advant¬ 
ages associated with the subcontrol points are: 

• Isolating one subcontrol point from other 
subcontrol points and the transaction 
executive* This means that no application 
program can destroy the transaction 
executive or circumvent system security* 

• Blocking RA+l requests from a subcontrol 

point* No requests are allowed directly 
from a subcontrol point to NOS* Any such 
requests are intercepted by the system 

monitors, which return control to the 
transaction executive* Thus, the only RA+I 
requests a task can legally issue are those 
processed by the transaction executive* 

This includes requests to the data managers* 

The transaction subsystem allows a maximum of 31 
subcontrol points* An Installation parameter sets 
the number of subcontrol points that the transaction 
executive Initializes* When the transaction 
executive Is loaded, the operator can select a 

number of subcontrol points other than this default 
value* The number of subcontrol points must not be 
less than 2 nor greater than 31* Once the 
transaction subsystem Is Initialized, no change in 
the number of subcontrol points Is allowed* The 
optimum number of subcontrol points Is selected by 
the site* 

Each subcontrol point requires eight words of table 
space* No space, other than a table entry, is 
allocated for a subcontrol point unless it Is 
active* Each active subcontrol point has Ulg 
words reserved, beginning at RA, similar to those 
used for batch control points* 


MULTIMAINFRAME 

Under a multimainframe configuration, the transaction 
subsystem can be run on either or both mainframes* 
However, a data base and JOURO file (section 4) 
cannot be shared by the transaction subsystems* 
Each subsystem must have a unique data base* 


EXTENDED MEMORY 

TAP does not allow the use of your access to 
extended memory* However, the TAP procedure file 
can declare data files and libraries as extended 
memory-resident * 
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TASK/TRANSACTION EXECUTIVE INTERFACE 
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A task is Isolated from the data manager and the 
remainder of the system by the transaction 
executive. The Isolation guarantees that errors In 
a task do not propagate beyond the task. The 
following types of requests constitute the Interface 
between the task and the transaction executive. 

• Data manager requests 

• Journal file requests 

• Memory dump requests 

• System requests 

• Task scheduling requests 

• Input/output requestst 

• Task control requests 

• Task utility requests 

• Application recovery requests 

• System recovery requests 

Internally, a task performs a request by loading 
address RA+I of its subcontrol point. This activity 
Is not visible to the applications programmer who 
uses the macros or calls given In this section. The 
transaction executive uses the request parameters to 
determine what processing is required by the task. 
The address field and any fields in a parameter list 
that reference an address contained within the task 
are verified to ensure that the address referenced 
is within the task field length. 

Tasks communicate with each other and accumulate 
input by using the communication block. The 
communication block Is discussed next, followed by 
the types of requests. 


COMMUNICATION BLOCK 

Communication between a chain of tasks Is provided 
by the communication block. The initial input or 
the input from a terminal as a result of the WAITINP 
request (refer to Input/Output Requests later in this 
section) is also stored In the communication block. 
The communication block can be used to pass parame¬ 
ters or data from task to task. The format of the 
communication block is shown in figure 2-1. The 
length of terminal Input is not restricted by the 
length of the communication block. The LOAOCB re¬ 
quest is available Co read extra Input that overflows 


Che communication block (refer to the description of 
m in figure 2-1). If the communication block is 
passed between casks In a transaction and overflow 
data is present, other casks in the transaction can 
access this data with a LOADCB request. 


If COBOL is used, the communication block must be 
described in the COMMON-STORAGE SECTION. Shown here 
is an example of such a description: 


DATA DIVISION. 

COKMON-STORAGE SECTION. 

01 COMMUNICATION-BLOCK. 

03 CB-HEADER-AREA-WORD-ZERO. 


os CB-OATA-BASE-NAME 


PIC 

X(2). 

05 CB-USER-TST-AREA 

COMP-A 

PIC 

9(6). 

05 C8-TRANS SEQ-NUMBER 

COMP-A 

PIC 

9(6). 

03 CB-HEADER-AREA-WORD-ONE. 




05 CB-U5ERNANE 


PIC 

X(7). 

05 CB-INPUT-STATUS-BYTE 

COMP-A 

PIC 

9. 

05 CB-MESSA6E-W0RD-C0UNT 

COMP-A 

PIC 

99. 

03 CB-MESSAGE-AREA 


PIC 

X(570) 

03 USER-AREA 


PIC 

X(90). 

03 CB-TRAILER-AREA. 




05 FILLER 


PIC 

X(A). 

05 CB-PACKED-OATE. 




07 CB-YEAR 

COMP-A 

PIC 

9. 

07 CB-nONTH 

COMP-A 

PIC 

9. 

07 CB-DAY 

COMP-A 

PIC 

9. 

05 CB-PACKED-TIME. 




07 CB-HOUR 

COMP-A 

PIC 

9. 

07 CB-MIKUTE 

COMP-A 

PIC 

9. 

07 CB-SECOND 

COMP-A 

PIC 

9. 


WORKING-STORAGE SECTION. 


This will be referred to in the manual as the 
standard COBOL communication block because of the 
correspondence between it and the fields shown and 
described in figure 2-1. However, applications 
programmers may find It convenient to use a more 
abbreviated communication block when possible. 


COMP-A is specified for data areas Intended for 
nunerlcal information. Refer to the COBOL 5 Refer¬ 
ence Manual for information on the relationship 
between the nunber of digits specified in the 
picture clause for COMP-A data and the number of 
bits reserved. 


tThe standard CMR-supported, compiler-generated I/O calls from FORTRAN and COBOL are not allowed. The COBOL 
SORT verb Is not supported. 
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59 47 35 29 23 20 17 15 13 11 5 

nig 

WORD 0 

WORD 1 
WORD 2 


WORD 67 

WORD 68 
2158 

data base Data base that the originating terminal is validated to use* 

user area Image of originating terminal user area from the terminal status table (refer to section 

8 ). Contains the recovery flag. (Refer to the TARO and TSIM requests for more 
Information*) 

transaction Assigned by the transaction executive to each newly Initiated transaction* This number is 

sequence number generated by Incrementing a counter by one and Identifies the transaction, or task chain, 

throughout Its life in the subsystem* 

Id The first octal digit of the transaction sequence number* It Is the 

Identifier for the network file under which the user running this transaction 
Is defined* The value Is zero to seven. . 

username One- to seven-character user name, left-justified with binary zero fill from the terminal 

status table* 

st Bit 17 of word 1 Is set to one If this communication block was created by a TAF-orlglnated 

transaction* Word 2, and possibly 3, of the communication block contains additional In¬ 
formation (operating system or network-defined conditions that may be processed by TAF- 
orlglnated tasks)* Refer to section 11 for Information concerning required system tasks* 

pf Bit 16 of word 1 Is set to one If this communication contains data on which a parity 

error occurred during terminal Input. 

bt Bit 15 of word 1 Is set to one If this communication block was created by a batch 

transaction (BTRAN request). 

c Bit 14 of word 1 Is set to one If CDCS aborts* 

1 Bit 13 of word 1 Is set to one If TAP Is Idling down. 

mt Bit 12 of word I Is set to one If additional Input to be loaded by means of the LOAOCB 

request exists. 

message Length of the Input message is words In the communication block proper* 

word count 

message area A message from a terminal (as a result of Initial terminal Input, WAITINP, or BWAITINP re¬ 
quests) begins at word 2 and Is terminated by 12 bits of zero In positions 11-0 of the 
last word of the message. All remaining message area words contain binary zero* The max¬ 
imum length of a terminal message Is 57 words* This area may also contain data from a 
BTRAN request* The maximum length of a BTRAN message Is 62 words* In all cases, the 
length of the message Is In the message word count field* The Information contained In 
this area Is available to you, and Its contents is passed to any communication block gen¬ 
erated by the processing of a CALLTSK or CALLRTN request. To retain the terminal Input, 
you may only write in words message word count4‘2 through 67* If there is no need to 
retain the terminal Input, the entire area can be used. 

yr, mo, day. Date and time In packed binary format from the operating system FDATE macro* 
hr, min, sec 



tThe main purpose of these fields Is to notify the system task ITASK of certain conditions. Under COBOL, 
the EXTRACT routine allows examination of these fields. Also, a COBOL data type, computatlonal-4, can be 
used to access these fields more easily; computatIona1-4 data types are allowed only on COBOL Version 5*2 
and above. ITASK Is described in section 12, and EXTRACT is described later In this section. 


Figure 2-1. Communication Block Format 
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If FORTRAN is used, the communication block must be 
in the first block of labeled conmon. 

If more data Is Input than can be contained In the 
coomunlcatlon block, the LOADCB request may be used 
to obtain the input. 


REQUESTS 

The following paragraphs describe the various types 
of requests a task can make. They describe task 
scheduling, input/output, task control, and task 
utility requests and show the formats for making 
these requests from tasks written in FORTRAN, COBOL, 
and COMPASS. 


COBOL Statements 

ACCEPT X FROM DATE. 
ACCEPT X FROM TIME. 
ACCEPT item FROM TTY. 
DISPLAY item UPON TTY. 


These requests are described in detail in Voluae 4 
of the NOS 2 Reference Set, FORTRAN Extended 4 
Reference Manual, FORTRAN 5 Reference Manual, and 
the COBOL 5 Reference Manual. (Refer to the preface 
for publication ntinbers.) 


DATA MANAGER REQUESTS 

A task can make data manager requests to one of the 
data managers, (CDCS, CRM, or TOTAL) supported by 
the transaction subsystem. (Refer to the preface 
for a list of the publications that dociznent these 
data managers and the requests used.) 


MEMORY REQUESTS (COMPASS ONLY) 

Tasks can interrogate the status of and change their 
central memory (Ol) field length (FL) via the RA+1 
requests MEM and RFL. The format of these calls is 
docmented for the MQ10RY macro In the NOS 2 
Reference Set, Volume 4. The use of these requests 
In TAF Is restricted as follows: 


JOURNAL RLE REQUESTS 

A task can supplement automatic journaling by 
writing data on a journal file. Journal files and 
the journal requests are discussed In section 4. 

MEMORY DUMP REQUESTS 

These requests are discussed In section 6. 

SYSTEM REQUESTS 

System requests from transaction tasks are limited 
to the following. 

COMPASS Macros 


ABORT 


DATE X 


ENDRUN 


JDATE X 


MBICRY 

(as described below) 

MESSAGE X 

(to console B display, line one 
only) 

PDATE X 


RTIME X 


TIME X 



JDATE(x) or CALL JDATE(x) 
TIME(x) or CALL TIME(x) 


• Memory requests should be Issued with the 
recall (r parameter); otherwise, control may 
be returned before the request Is processed. 


• There Is an upper limit beyond which a task Is 
not allowed to Increase Its CM space; this 
limit Is referred to as the maximum task field 
length (MFL). The MFL for each task Is equal 
to the task FL plus the value specified by the 
EF LIB TASK directive for the task (refer to 
section 10). If a task attempts to exceed 
this value, it may be aborted (refer to docu-- 
mentation of the MEMORY macro NA parameter In 
the NOS 2 Reference Set, Volume 4). 


• Field length cannot be decreased to less than 
the last word address of the default commun¬ 
ication block transfer address rounded up to 
the nearest lOOg. 


• A non-CM-resldent task making a memory request 
may be rolled out of Q1 If the request cannot 
be satisfied Initially. 

• Since a task making a memory request may be 
rolled out. It may be desirable to free locked 
data manager resources prior to the request. 

Tasks will also be allowed to use the common memory 
manager (CMM) with the following restrictions: 


• The processing performed by CMM for the task 
must not result In CMM using the fast dynamic 
loader or the task will be aborted. 


The preceding restrictions on use of MEM and 
RFL requests apply. 

Common memory manager requests are documented In 
detail in the Common Monory Manager I Reference 
Manual. 


FORTRAN Functions and Subroutine Calls 
DATE(x) or CALL DATE(x) 
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MESSAGE REQUESTS 

COMPASS tasks can issue messages to the operator or 
the JOURO file by using the RA+1 request MSG. The 
function code determines the disposition of the 
message. Function code zero causes the message to 
be written to only the JOURO file. Function code 
one causes the message to be placed In line one of 
the B display. 

FORTRAN termination messages are also written to the 
JOURO file. 

COBOL and FORTRAN tasks can Issue messages to TAFT'S 
dayfile by using the TMSG request. The tasks that 
Issue this request must reside In the system task 
library. TASKI-I 6 

The TMSG request Issues a message to TAFT'S dayfile. 


The format Is: 
COBOL 


ENTER TMSG USING message[,length]. 

message A 01-level data Item containing 
the dayfile message. 

length A computational-1 data item 

specifying the length of the 
message In characters. The 
maximum length Is 80 characters* 


FORTRAN 

CALL TMS 6 (message*length) 

message The name of the array that 
contains the dayfile message. 

length An Integer specifying the length 

of the message In characters. 
The maximum length is 80 
characters* 


TASK SCHEDULING REQUESTS 

A task, including ITASK (refer to section 11), can 
call In order a list of other tasks* This process 
is referred to as task scheduling* The following 
four requests can be used to schedule tasks. 

• CALLRTN 

Calls up to five tasks. Upon completion of 
the called chain of tasks, returns control 
to the calling task* 

• CALLTSK 

Calls up to five tasks. The task making the 
call either ceases or continues to run, 
allowing the new task chain to proceed 
independently. 


• NEUTRAN 

Initiates up to five new tasks (COMPASS 
only)* 

• TRANCHK 

Checks to see if a specific task is active 
(COMPASS only). 


I NOTE I 

If a list has either no tasks or more 
than five tasks, TAF aborts the task 
and Issues the following error 
message on the screen* 

TASK REQUEST ARGUMENT ERROR 


CAURTN Request 

The CALLRTN request is used to request that the 

transaction executive schedule a task or series of 

tasks, with control returning to the calling task 

upon completion of the called tasks* A CALLRTN 
request cannot be made while data manager requests 
are outstanding* The current communication block is 
passed to the called tasks and returned to the 
caller when the caller is reinitiated* Upon return, 
the caller begins execution immediately after the 
CALLRTN request. Only the Information in the 
communication block may have changed* E^turn from 
the called tasks to the caller takes place 

automatically after the last called task ceases* A 
task waiting for return may be temporarily rolled 
from memory* 

The format is: 

COBOL 

ENTER CALLRTN USING taski task 2 ...taskn* 

taskj^ Parameter whose value is a one- 

to seven-character alphanumeric 
task name* The tasks are 
scheduled by CALLRTN in the 
order specified. From one to 
five tasks can be specified. 

FORTRAN 

CALL CALLRTN(task^,task 2 ,.*•.task^) 

task{^ Parameter whose value is a one- 

to seven-character alphanumeric 
task name, left-justified with 
either blank or binary zero fill 
to a word boundary. The tasks 
are scheduled by CALLRTN In the 
order specified. From one to 
five tasks can be specified. 
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COMPASS 

CAIXRTN address 

address Address of a list of from one to 
five task names. Each task name 
must be left-justified vith 
binary zero fill to a word 
boundary. The list is 

terminated by a word of binary 
zeros. Tasks are scheduled by 
CALLRTN in the order they appear 
on the list. 


I notTI 

If tasl 4 , specified on a CALLRTN 
request, makes a CALLRTN request, 
task^ + 1 through task^, speci¬ 
fied on the original CALLRTN request, 
are not scheduled. (Refer to figure 
2-4.) 


The following diagrams illustrate CALLRTN processing. 


In figure 2-2, TASK A, at subcontrol point X, 
executes a CALLRTN to TASK B. TAP will first load a 
copy of TASK B to an available subcontrol point 
(unless a serially reusable copy of TASK B is 
already at a subcontrol point or CM-resident). TAP 
will then copy the contents of TASK A's 
communication block (CB) to TASK B's communication 
block area. TASK B begins execution. When TASK B 
has completed execution, TAP will copy the 
communication block, which was probably modified by 
TASK B, back to TASK A and allow TASK A to continue 
execution at the instruction Immediately following 
the CALLRTN command. 


communication block back to the calling task and 
allow it to continue execution at the Instruction 
immediately following the CALLRTN command. 


TASK 

A 



TASK 

B 


TASK 

C 


TASK 

O 


Figure 2-3. CALLRTN (Chain) 


Figure 2-4 illustrates the processing referred to in 
the preceding note. The majority of the data inputs 
are handled by the TASK B-C-D chain. When an excep¬ 
tion is found in TASK C, exception processing is 
invoked in the TASK E-F chain. Each new CALLRTN 
command cancels the previous one (TASK D Is not 
executed) , but TAP will always bring control back to 
the instruction immediately following the original 
CALLRTN command (TASK A). The communication block 
is passed from task to task as shown in figures 2-2 
and 2-3. 
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Figure 2-2. CALLRTN 


The CALLRTN command allows a chain (list) of up to 
five tasks to be called. Figure 2-3 shows TASK A 
calling a chain of three tasks* As each task In the 
chain is completed, TAF will automatically pass the 
communication block to the next task in the chain 
and allow that task to execute. When the last task 
in the chain has completed, lAF will pass the 
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TASK 
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Figure 2-4. CALLRTN (Multiple Chains) 
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CALLTSK Request 

The CALLTSK request is used to request that the 
transaction executive schedule a task or series of 
tasks (task chain). Included in this request is a 
parameter option that enables task branching or a 
CEASE function to be performed after the call is 
honored. If the task is not to cease on this call, 
a branching of the chain initiates a new chain that 
is Independent of the original chain. The new chain 
is assigned a new sequence ntmber for unique 
identification within the transaction subsystem 
(figure 2-1). The nunber of branches allowed by a 
transaction is controlled by an assembly constant 
MAXBW. If a CALLTSK request without a CEASE request 
Is issued from a recoverable transaction, recovery 
may be affected. Refer to CALLTSK without CEASE and 
Recovery In section 7. 


The format is: 

COBOL 

ENTER CALLTSK USING task code task^.. .task^. 

task Parameter whose value is a one- 

to seven-character alphanuneric 
task name. This task is the 

next task to call in the present 
task chain (same sequence 
nunber) if code is set to zero; 
otherwise, it is the first task 
of a branch chain (the called 
task gets a different sequence 
nunber and proceeds independently 
of the calling task). 

code Computational-1 item whose value 

is nonzero if the calling task 
is to continue after the 

request, initiating an 

independent task chain. If the 
value of this parameter is zero, 
the calling task ceases after 

this request. This parameter 
must be specified. 

task^ Parameter whose value is a one- 

to seven-character alphanuneric 
task name. From zero to four 

tasks can be specified. These 
tasks are scheduled after the 
one specified in the task 
parameter. 


FORTRAN 

CALL CALLTSK(task,code,task|,... ,task^) 

task Parameter whose value Is a one- 

to seven-character alphanuneric 
task name, left-justif led with 
either blank or binary zero fill 
to a word boundary. This task 
is the next task to call in the 
present task chain (same 
sequence nunber) if code is set 
to zero; otherwise, it is the 
first task of a branch chain 
(the called task gets a 
different sequence number and 
proceeds independently of the 
calling task). 


code Integer whose value Is nonzero 

if the calling task is to con¬ 
tinue after the request, initiat¬ 
ing an Independent task chain. 
If the value of this parameter 
is zero, the calling task ceases 
after this request. If not 
specified, the defatilt Is zero. 

taskj Parameter whose value is a one- 

to seven-character alphanumeric 
task name, left-justified with 
either blank or binary zero fill 
to a word boundary. From zero 
to four tasks can be specified. 
These tasks are scheduled after 
the one specified in the task 
parameter. 

COMPASS 

CALLTSK address,cease 

address Address of a list of from one to 
five task names. Each task name 
must be left-justified with bina¬ 
ry zero fill to a word boundary. 
The list is terminated by a word 
of binary zeros. CALLTSK sched¬ 
ules the tasks in the order they 
appear on the list. 

cease If specified, the calling task 

ceases after this request. If 
not specified, the calling task 
continues after the request * In 
this case the CALLTSK initiates 
an independent task chain. 

The following figures illustrate CALLTSK processing. 

Figure 2-5 shows TASK A making a CALLTSK with a CEASE 
request to TASK B. TAF will load a copy of TASK B to 
an available subcontrol point (this step is not nec¬ 
essary if a serially reusable copy of TASK B is al¬ 
ready at a subcontrol point or is CM-resident). The 
communication block will be copied from TASK A to 
TASK B. TASK A^s subcontrol point is released for 
use by other transactions, and TASK B is allowed to 
begin execution. 



Figure 2-5. CALLTSK with CEASE Request 
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The CALLTSK without a CEASE request allows a new 
asynchronous chain to be started. In figure 2->6, 
TASK A uses this command to call TASK B. T^ will 
copy the contents of TASK A's communication block to 
a new communication block. A copy of TASK B will be 
loaded to an available subcontrol point (unless a 
serially reusable copy of TASK B is already at a 
subcontrol point or is CM-resident). The new 
communication block will be copied to TASK B. TASK 
A Is allowed to continue execution and TASK B Is 
allowed to begin execution. 


NEWTRAN Request (COMPASS Only) 

The NEWTRAN request Initiates a new transaction 
chain with a unique sequence nunber and with the 
data base, user area, and user name set to zero In 
the communication block. The NEWTRAN request Is 
designed for system use, primarily by TTASK, and is 
provided only for COMPASS. 

The format is: 

COMPASS 

NEWTRAN address 

address Address of a parameter table in 
the form shown In figure 2-7. 


TASK 

A 



# • 

• • 


TASK 

B 


Figure 2-6. CALLTSK without CEASE Request 
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sequence The transaction executive returns a new 2A-blt binary transaction sequence ntinber 

in this field. 

taskj^ One- to seven-character task name, left-justified with binary zero fill. From 

one to five tasks can be specified; the list Is terminated by a word of binary 
zeros* NEWTRAN schedules the task in the order they appear on the list. 


Figure 2-7. NEWTRAN Parameter Table 
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TRANCHK Request 

The TBANCHK request determines the status of a 
transaction* This request is provided only for 
COMPASS. 

The format is: 

COMPASS 

TBAMCHK address 

address Address of a parameter table in 
the form shown in figure 2*'8. 


• BLDABH 

Builds Che application block header to use 
different character types, terminal format 
effectors, and auto input. 

• GETABH 

Returns the last application block header to 
Che task. 


e TERMDEF 

Defines the operational controls or format 
of the terminal. 


INPUT/OUTPUT REQUESTS 

The following requests are associated with 
input/output« 

• WAITINP 

Places terminal input data in the 
communication block. Equivalent to a read 
request• 

• LOADCB 

Reads data that overflowed the communication 
block. 

• SETCHT 

Sets character type for terminal Input. 


• SEND 

Sends data to terminal. Equivalent to a 
write request. 

• RELSCB 

Releases memory used for extra communication 
blocks. 

• TSIH 

Reads terminal status table, 

• lARO 

Writes into terminal status table. 


S9 41 17 0 


777777777777777777777777 . 




tequancs 

stttut 


sequence Binary transaction sequence ntmber which Identifies the transaction (task or 

task chain). 

status The system returns one of the following as status in this field. 

1 The task chain is still active. 

0 The task chain is Inactive. 


Figure 2-8. TRANCHK Parameter Table 
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• no 

Limits total number of requests (RA+1 calls) 
a task can make* 

• BWAITINP 

Specifies that terminal input data is to be 
placed In a location in the task field length 
that is not reserved for the communication 
block, 

• TPSTAT 

Returns a value indicating that the active 
terminal subsystem is NfAM, 

• BEGIN 

Specifies the area where the terminal trans¬ 
mission is to be placed in the task field 
length. It does not return the communication 
block to the first word address of the task 
unless the task requests. 


WAITINP Request 

The WAITINP request (wait for terminal Input) reads 
data from a terminal. Internally, this request in¬ 
forms the transaction executive that the next input 
received from a terminal Is to be passed directly to 
the requesting task and is not to initiate a new 
transaction. The data entered is placed in the mes¬ 
sage area of the communication block. The data held 
in the communication block prior to the WAITINP is 
lost. 

The first parameter Is a data item or variable whose 
value the system sets to indicate the reception of 
terminal input or an error condition. An optional 
second parameter of the request specifies a time 
limit, after which processing of the transaction is 
restarted even if no input has been received from 
the terminal. 


1 noteI 

CM-resldent tasks and tasks not asso¬ 
ciated with a terminal (batch origin) 
are not permitted to make a WAITINP 
request (task aborts). 

At least one message (SEND) must be 
sent to the terminal before making a 
WAITINP request, and at least one SEND 
request from the original task chain 
must follow a message received follow¬ 
ing a WAITINP request. 

No data manager requests may be active 
when a task makes a WAITINP request. 
All tasks that make WAITINP requests 
must be entered in the task library 
with the scheduling queue limit set 
to one, (Refer to section 10.) 

WAITINP does not cause any data mana¬ 
ger cease requests to be Issued, 
Therefore, any resources locked or 
reserved by a transaction prior to a 
WAITINP continue to be locked or 
reserved during and after the WAITINP. 


When a WAITINP request is processed, all communica¬ 
tion blocks are released and the task is rolled out. 
All data in the communication block, except the 
transaction sequence number, will be lost, so the 
user should save any data to be preserved prior to 
the request. When input arrives from the terminal, a 
new communication block is generated, and the task is 
restarted. The new communication block will contain 
the transaction sequence number associated with the 
task prior to the WAITINP request. If the request 
does not return a normal status, the information in 
the communication block is meaningless. 

The format is: 

COBOL 

ENTER WAITINP USING status time, 

status Computational-i item that the 

system sets to indicate the sta¬ 
tus of the WAITINP request. Upon 
completion of the request, status 
has one of the following values, 

0 The request processed 

normally; terminal input 
appears in the normal 
input portion (begins in 
the third word) of the 
communication block. 

< 0 Another task is waiting 

for input from the origi¬ 
nating terminal. The 
WAITINP request must be 
reissued if input is 
desired, 

> 0 The time delay elapsed 

before Input was received 
from the terminal, 

time Computational-! item that con¬ 
tains the time limit, in decimal 

seconds, to wait for input. If 

not specified, the default is 480 
seconds. The maximum value is 
2048 seconds. 


FORTRAN 

CALL WAITINP(status,time) 

status Integer variable that the system 

sets to indicate the status of 
the WAITINP request. Upon com¬ 
pletion of the request, status 
has one of the following values, 

0 The request processed 

normally; terminal input 
appears in the normal 
input portion (begins in 
the third word) of the 
communication block, 

< 0 Another task is waiting 

for input from the origi¬ 
nating terminal. The 
WAITINP request must be 
reissued if input is 
desired. 


60459500 C 


2-9 



> 0 The time delay elapsed 
before input was received 
from the terminal* 

time Integer time limit, in decimal 

seconds, to wait for input. If 
not specified, the default is 
480 seconds. The maximum value 
is 2048 seconds. 


The overflow data can be requested as many times 
during a transaction as desired. Each time, the 
overflow data is transmitted as specified previously. 

The format is: 

COBOL 

ENTER LOADCB USING buffer status r. 


COMPASS 

WAITINP time 

time Time limit, in decimal seconds, 

to wait for input. If not 
specified, the default is 480 
seconds. The maximum value is 
2048 seconds. 


Status of the WAITINP macro is determined by the 
following: 

• Word 2 of the communication block contains 1 
if the time delay elapsed before input was 
received from the terminal. 

• The X6 register contains a negative value if 
another task is waiting for input from the 
originating terminal. The WAITINP request 
must be reissued if input Is desired. (Word 
2 of the consnunication block should be 
checked before X6 is checked.) 

• The X6 register is set to zero if the request 
processed normally; terminal input appears in 
the normal input portion (begins in the third 
word) of the communication block. (Word 2 of 
the communication block should be checked 
before X6 Is checked.) 


LOADCB Request 

If the transaction input data exceeds the message 
area of the communication block, bit 12 of word 1 of 
the communication block (the i field) is set. The 
LOADCB request loads the remainder of the input 
message into a user-defined buffer. This buffer is 
a single contiguous block of storage for all 
additional communication blocks* No headers or 
trailers appear in this area. 


buffer 

A Ol-level item identifying 
user-defined buffer area. 

the 

status 

Computational-1 

item that 

the 


system sets to 

indicate 

the 


LOADCB equest 

status• 

The 


significance of 

the value 

set 


has been described earlier 

in 


the LOADCB request description. 

r Computational-1 item. If a non¬ 

zero value is entered for this 
parameter, any message data that 
overflows the LOADCB buffer spec¬ 
ified with the buffer parameter 
is released (same as RELSCB). 

FORTRAN 

CALL L0ADCB(buffer,length,status ,r) 

buffer An array identifying the user- 

defined buffer area. 

length Integer length of the array spec¬ 

ified with the buffer parameter 
in words. 

status Variable that the system sets to 

indicate the LOADCB request 
status. The significance of the 
value set has been described 
earlier in the LOADCB request 

description. This value is also 
returned as the value of the 
function, if LOADCB is called as 
a FORTRAN function. 

r Integer variable* If a nonzero 

value is entered for this param¬ 
eter, any message data that over¬ 
flows the LOADCB buffer specified 
with the buffer parameter is 

released (same as RELSCB). 


The maximum input size is determined by an installa¬ 
tion parameter. 

The data that remains after the communication block 
message area fills (referred to here as overflow 
data) is transferred to the user-defined buffer. If 
the LOADCB request is made with no data overflow (i 
field not set) or if a RELSCB request was made prior 
to the LOADCB request, no data is transferred and the 
status word is set to zero. If the overflow data 
consists of more words than will fit in the buffer, 
the buffer is filled, and the status word is set to 
a value greater than the number of words in the 
buffer. If the overflow data can be contained in 
the buffer, the overflow data is transferred to the 
buffer, and the number of words transferred is set 
in the status word. 


As stated in the description of the status 
parameter, the LOADCB request can be referenced as a 
FORTRAN function. The format of the function is 
LOADCB(buffer,length,status ,r); the parameters are 
the same as those already described* The value of 
the function is the value of the status parameter. 

COMPASS 

LOADCB address 

address Address of a parameter table in 
the format shown in figure 2-9. 

The LOADCB macro status is returned in the X6 regis¬ 
ter. The significance of the value returned has been 
described earlier in the LOADCB request description. 
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SETCHT Request 


The format is: 


The SETCHT request allows a task to change the appli¬ 
cation character type (ACT) of terminal messages 
placed in the coonnunication block. 


rNorD 

This is an optional request; the de¬ 
fault character type is 6-blt display 
code characters. 


The following character types are available. 

• 7-bit ASCII, seven and one-half characters 
per word. 

• 7-blt ASCII characters, right-justified in 
12-bit bytes, five characters per word. 

• 6-bit display code characters, 10 characters 
per word. 

This request causes TAP to send a change input char¬ 
acter type supervisory message to NAM. For more 
information about supervisory messages, refer to the 
NAM/CCP Reference Manual. 


rNo^ 

This request does not change the data 
currently held in communication 
blocks for the task. For example, a 
LQADCB request gets data in the 
former character type, while the next 
WAITINP request gets data in the new 
character type. 

If 7-bit ASCII characters are used to 
originate transactions, ITASK transac¬ 
tion tables must be set up in terms 
of ASCII and not display code. 


COBOL 

ENTER SETCHT USING username status act. 

username A 01-level item containing a 
one- to seven-character user 
name, left-justified with blank 
fill. The user name may also be 
specified with a computational-1 
item with binary zero fill. If 
the item contains only binary 
zeros, the character type 
applies to the originating 
terminal. This user name must 
be a name appearing in an NCTFi 
file. A user name consisting of 
the character P with binary zero 
fill cannot be specified. 


status Computational-1 item whose value 

is set by TAF to indicate user 
name status. This value is zero 
if the user is not logged in and 
one if the request is processed 
normally. The task is aborted 
if the user name is not defined 
or if the data base for the 
specified user does not match 
the data base of the originating 
user. 

act A 01-level item containing one 

of the following words, 
left-justified. 

ASCII7 7-bit ASCII. Seven 
and one-half char¬ 
acters per word. 

ASCIIS 7-bit ASCII, right- 
justified in 12-bit 
bytes, five charac¬ 
ters per word. 

DISPLAY 6-blt display code. 


59 


leng th 
buffer 


47 


29 


17 



langth 


buffer 






If bit 59 is set to one, any message data that overflows the LOADCB buffer 
is released (same as RELSCB). 

Length of the LOADCB buffer in words. 

First word address of the buffer area. 


Figure 2-9. LOADCB Parameter Table 
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FORTRAN 

CALL SETCHTC username, s tat us ,act) 

username One- to seven-character user 
name, left-justified with zero 
or blank fill* If the terminal 
name is zero, the character type 
applies to the originating termi¬ 
nal* This user name must be a 
name appearing in an NCTFi file. 

status Unnonaalized floating-point num¬ 

ber whose value specifies the 
user name status* This value is 
zero if the user is not logged 
In and one if the request is 
processed normally* 

The task is aborted if the user 
name is not defined or if the 
data base for the specified user 
does not match the data base of 
the originating user* 

act Parameter containing one of the 

following words, left-justified 
with binary zero or blank fill* 

ASCII? 7-blt ASCII, seven 
and one-half char¬ 
acters per word. 

ASCII5 7-blt ASCII, right- 
justified in 12-blt 
bytes, five charac¬ 
ters per word. 

DISPLAY 6-blt display code* 


COMPASS 

SETCKT address 

address Address of a parameter table in 
the form shown in figure 2-10* 


BLDABH Request 

The BLDABH request builds or modifies the application 
block header (ABH). This header accompanies every 
block passing between TAF and NAM, and thus is used 
during communication between TAF and terminals* It 
contains detailed infonnatlon describing the block 
it accompanies* 

I NOTE I 

This is an optional request* The 
default application block header spec¬ 
ifies 6-blt display code characters, 
nontransparent mode, no format effec¬ 
tors, and no auto input* 


To use some of the NAM features, a task must use the 
BLDABH request to modify the ABH. Some of the 
features provided via the ABH are: 

• Character type specification of messages sent 
to a terminal* Either 7-blt ASCII or 6-blt 
display code characters may be used* 


• Transparent mode specification* Transparent 

mode inhibits all data transforms and allows 
the task direct access to the real terminal 
features• 

• Terminal format effector specification* 

Format effectors control printing (or the 

cursor on display terminals)* 

• Auto-input mode specification* Auto-input 

mode allows a fill in the form type of trans¬ 
action. This is provided since the first n 
characters of a message output to the termi¬ 
nal via the SEND request (ABT=2 only) can be 
used to form the first n characters of subse¬ 
quent input from the terminal. If n is 
greater than 20, only the first 20 characters 
are returned, followed by the entered text. 

It is not necessary to use the BLDABH request before 
every SEND* It is needed when a selectable param¬ 
eter on the ABH for the next SEND differs from a 
setting on the ABH for the previous SEND* In other 
words, a setting of a parameter once selected by 
BLDABH stays in effect for that task unless changed 
by a subsequent BLDABH request* If a task issues a 
BLDABH request and then calls another task, the new 
task must also issue a BLDABH request becaiise the 
request parameters are not passed to it* If a task 
is to be reusable, the task should initialize the 
ABH if the default values have been changed. 

Default values are supplied on the ABH* If the 
default values are the desired values, no BLDABH 
request is required* Default values have been 
selected to remain compatible with prior versions of 
the transaction subsystem* 

The format is: 

COBOL 

ENTER BLDABH USING field^ value. .fields value^. 

field^ A 01-level item containing a 

three-character, left-justified 
field for which a value is to be 
set* fieldcan be binary zero 
or blank-filled. The possible 
values are listed in table 2-1* 

value A computational-1 item whose 

value is set for the correspond¬ 
ing field j^* The fields and 
valuej[ parameters must appear 
in pairs* The possible values 
and descriptions are listed in 
table 2-1* 

FORTRAN 

CALL BLDABH(field^,valuex, *•*,field,),valuetj) 

fields Variable containing a three- 

character, left-justified field 
for which a value is to be set* 
field^ can be binary zero or 
blank-filled. The possible 
values are listed in table 2-1* 

valuej^ Integer that is set for the 

corresponding fieldThe 
field and value^ parameters 
must appear in pairs. The 
possible values and descriptions 
are listed in table 2-1* 
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Example: 


COMPASS 


The following request builds the ABH with ACT»4, 
NFE-0» and AIM»1« 

CA LL B LDABH (3LAC T, 4^ 3LNF 0^ 3LAIM, 1) 


The COMPASS user specifies changes to the ABH 
with the SEND request (described later in this 
section)• 


username 


type 


status 


17 


username 


type 


status 


One- to seven-character user name, left-justified with zero fill* If the user 
name Is zero, the character type applies to the originating terminal* 

Binary value for character type: 

2 7-blt ASCII, seven and one-half characters per word. 

3 7-blt ASCII, right-justified In 12-blt bytes* 

4 6-blt display code* 

Address of a word In which TAF returns an unnormalized floating-point number to 
Indicate the user status* This value Is zero If the user Is not logged In and 
one If the request Is processed normally* The task Is aborted If the user name 
Is not defined or If the data base for the specified user does not match the 
data base of the originating user* 


Figure 2-10* SETCHT Parameter Table 



Table 2-1* BLDABH Request Parameters 


fleldi 

valuer 

Description 


fleldi 

value^ 

Description 

ACT 


Application character 



It 

No format effectors In 



type. 




the message* 


2 

7-blt ASCII charac- 


AIM 


Auto-Input mode* 



ters, seven and one- 
half per word* 



0 

No auto-Input mode. 


3 

7-bit ASCII charac- 



It 

Auto-Input mode se- 



ters, right-justified 

In 12-blt bytes, five 




lected* 



per word* 


XPT 


Transparent mode* Ap¬ 

plies only to 7-blt 


4t 

6-blt display code 
characters, 10 per 



ot 

ASCII character types. 



word* 



Interactive virtual 
terminal data transforms 
to console devices are 


NFE 


Format effectors In 




performed. (This option 



message* 




must be selected for 
output to batch devices.) 


0 

Format effectors ap¬ 
pear In the message* 



1 

IVT transforms are 



(Refer to the NAM/CCP 
Reference Manual*) 



i 

Inhibited* 


tThese are default values supplied by TAF, FORTRAN, and COBOL library routines for BLDABH and SEND* 
These are also the default values for the COMPASS SEND request when the task does not specify the ABH. 
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GETABH Request 

The GETABH request allows a task to examine the ABH 
that accompanied the last message. 


I NOT6 I 


This Is an optional request. Terminal 
Input and output can be done without 
using it. 


If no SEND has been issued since the last input from 
tt£ terminal, the GETABH request allows the task to 
obtain the ABH that accompanied the input block from 
the network. If a SEND has been issued, the ABH 
used for the SEND is obtained. This request is 
useful for obtaining the character type, character 
count, axKi parity error fields. 


rNorTI 

The parity error indicators can also 
be obtained from the communication 
block, but it may be easier for the 
COBOL task to use GETABH to obtain 
this indicator. 


The format is: 

COBOL 

ENTER GETABH USING username status fie Id ^ 
value^...fieldii value^. 

username A 01-level item containing a one- 
to seven-character user name, 
left-justified with blank fill. 
The user name may also be 
specified with a computetional-1 
item with binary zero fill. If 
the item contains only binary 
zero, the ABH for the originating 
terminal is returned. This user 
name must be a name appearing in 
the NCTFl file. A user name 
consisting of the character P 
with binary zero fill cannot be 
specified. 

status Computetlonal-1 item whose value 

is set by lAF to indicate the 
status of the user name. status 
contents is zero if the user is 
not logged in and is one If the 


request is processed normally. 
The task is aborted if the user 
name is not defined or if the 
data base for the user name does 
not match the data base of the 
originating user. 

field^ A 01-level item containing a 

three-character field for which a 
value is desired, left-justified 
with binary zero or blank fill. 
The possible fields and values 
are described in table 2-2. 

value^ Computetlonal-1 item in which the 

value for the desired field is to 
be returned. The fields and 
value^ items must appear in 
pairs. 

FORTRAN 


CAIL GETABHCxisername,status ,field|,value^ 
fields ,valueii) 


username Parameter whose value is a one- 

to seven-character user name, 
left-justified with binary zero 
or blank fill. If the user name 
is binary zero, the ABH for the 
originating user is returned. 

status Uhnormalized floating-point num¬ 

ber whose value is set by TAF to 
indicate the user name status* 

status contents is zero if the 
user is not logged in and greater 
than zero if the request is 
processed normally* The task is 

aborted if the user name is not 
defined or if the data base for 
the user name does not match the 
data base of the originating user. 


field Variable containing a left- 

justified, three-character field 
for which a value is desired* 
The possible fields and values 
are described in table 2-2. 


value^ Name of an unnormalized floating¬ 
point variable in which TAF re¬ 
turns the value of the desired 
field. 


COMPASS 

GETABH address 

address Address of a parameter table in 
the format shown in figure 2-U. 
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Table 2-2. Application Block Header 


field^ I Bits valuer 


ABT 59-54 



ADR 53-42 


ABN 41-24 


ACT 23-20 


NFE 15 



Description 


Application block type. 
Null input block. 


Data block; not the last 
(applies to SEND only)• 

Data block; last or only 
block. 


Addressing information; TAF 
assigns this area for out¬ 
put, NAM for input. 

Application block number. 
This area is user- or TAF- 
asslgned for SEND requests. 
You assign this area caus¬ 
ing the block parameter on 
the SEND request. 

Application character type. 

7-bit ASCII characters, 
seven and one-half per 
word. 

7-bit ASCII characters, 
right-justified In 12-bit 
bytes, five per word. 


6-bit display code charac¬ 
ters, 10 per word. 

Format effectors. 

Format effectors are pres¬ 
ent in the SEND message. 


Format effectors are not 
present in the SEND 
message. 



fieldi 

Bits 

value^ 

1 Description 



Transparent bit. 

Nontransparent data; XVT 
transforms are used. 

If application character 
type is set to two or 
three, IVT transforms are 
inhibited. If ACT is set 
to four, this bit is 
ignored on output. 

For input, if XFT is set to 
one and ACT is set to 
four, TAF changes ACT to 
three. You must change ACT 
back to four when no more 
transparent input is 
expec ted. 

For input, parity error 
flag; for output, auto¬ 
input mode flag. 


No parity error, no auto¬ 
input mode. 

For input, a parity error 
was detected; for output, 
use of auto-input mode is 
specified. 

Text length in units speci¬ 
fied by ACT. Ihls field is 
assigned by TAF or by you 
for output. NAM assigns 
this field for input. The 
text length includes the 
unit separator. A unit 
separator is 12 through 66 
bits of zero for 6-bit dis¬ 
play code characters and US 
for 7-bit ASCII code 
characters. 



One- to seven-character user name, left-justified with binary zero fill. If the 
user name is zero, the ABH for the originating terminal is returned. 

Address of a word in which TAF returns are unnormalized floating-point number to 
indicate the user name status, status is zero if you are not logged In and one 
if the request is processed normally. The task is aborted if the user name is 
not defined or if the data base for the user name does not match the data base of 
the originating user. 


Application block header, 
table 2-2. 


The format and description of this word is listed in 


Figure 2-11. GETABH Parameter Table 
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TERMDEF Request 

The TEBMDEF request can be used by a task to define 
or modify terminal characteristics» where those of 
the connected real terminal differ from the assump¬ 
tions made for the network's IVT model. This request 
can also be used to tailor the operational controls 
of the terminal. 


I Notn 

This Is an optional request. Terminal 
input and output can be done without 
It. Each terminal that logs Into the 
network Is associated with a default 
set of terminal characteristics. (Re¬ 
fer to appendix G.) 


A complete list of terminal characteristics is pro¬ 
vided In the NAM/CCP Reference Manual and appendix G 
of this manual. Characteristics that may be modified 
Include: 

• Terminal physical page width. 

• Number of physical lines on a terminal page. 

• Specification of a character used to cancel 
an input logical line in progress. 

• Specification of a character to be used as a 
break character* User breaks are sent to 
the application task for processing. 

• Set transparent input mode. This setting 
exists for only one logical Input line. 

The format Is: 

COBOL 

ENTER T£E(MDEF USING username status field^ 

fleld2«•«fleldQ. 

username A 01-level Item containing a 
one- to seven-character user 
name» left-justified with blank 

fill* The user name may also be 
specified with a computational-1 
Item with binary zero fill. If 
the Item contains only binary 
zero, the terminal definition 
specified applies to the 

originating terminal. This user 
name must be a name appearing In 
an NCTFl file. A user name 

consisting of the character F 
with binary zero fill cannot be 
specified. 

status Computational-1 Item that TAF 

sets to indicate user name 

status, status contents Is zero 
If the user Is not logged In and 
is one If the request is 
processed normally. The task is 
aborted If the user name is not 
defined or If the user's data 
base does not match the data 
base of the originating user. 


fleldi A left-justified 01-level item 

with binary zero or blank fill, 
containing the characteristic 
(for example, PW»60, PL»35, or 

CN-2B). A maximum of 17 non¬ 
blank, nonbinary zero characters 
Is allowed. The characteristics 
are described in the NAM/CCP 
Reference Manual and appendix G 
of this manual. If the NAM/CCP 
Reference Manual specifies x or 
h, a 6-blt display code alphanu¬ 
meric representation Is required 
(where x Is a 7-bit ASCII charac¬ 
ter and h Is a hexadecimal 
character). 

FORTRAN 

CAIX TERMOEF(username,status ,field]^, 

field2 1f fleld^) 

username Parameter whose value is a one- 
to seven-character user name, 
left-justified with binary zero 
or blank fill. If the user name 
is zero, the terminal definition 
specified applies to the origi¬ 
nating terminal. This user name 
must be a name appearing in an 
NCTFl file. 

status Variable in which TAF places an 

unnormalized floating-point num¬ 
ber to Indicate user name status* 
status contents Is zero If the 
user Is not logged In and greater 
than zero If the request is proc¬ 
essed normally* The task Is 
aborted If the user name Is not 
defined or If the data base for 
the user does not match the data 
base of the originating user. 

field A left-justified variable with 

binary zero or blank fill, con¬ 
taining the characteristic (for 
example, PW«60, PL»35, or CN»2B). 
A maximum of 17 nonblank, non- 
binary zero characters Is 
allowed. The characteristics 
are described In the NAM/ CCP 
Reference Manual and appendix G 
of this manual. If the NAM/CCP 
Reference Manual specifies x or 
h, a 6-bit display code alpha¬ 
numeric representation Is 
required (where x Is a 7-blt 
ASCII character and h is a 
hexadecimal character). 


Example: 

The following request designates the page width 
to be 60 characters, the page length to be 40 
lines, and the plus character (ASCII representa¬ 
tion Is 2B) to be the cancel character for user 
USERS; it then assigns the status to variable 
STATUS. 

CALL TERMDEF(5HUSER5^STATUS,,5LPW=60^ 
5LPL=40^5LCN=2B) 
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Example: 

The following statements redefine the 
transparent input mode text delimiter to be a 
slant (ASCII representation is 2F) and the 
character count delimiter to be 4096. 

DATA MSG/10H0LsX2F^C4O^2L96/ 


CALL TERM0EF<5HUSER5^STATUS^MSG) 


END 

COMPASS 

TERMDEF address 

address Address of a parameter table in 
the format shown in figure 2-12* 


SEND Request 

The SEND request sends a message to a user; that Is, 
It performs a write operation. If the task does not 
specify the user to which the message should be 
sent, it is directed to the terminal that originated 
the transaction. At least one SEND request to the 
originating terminal must occur from the primary 
task chain for each message received. The task can 
also specify that the task be ended when the message 
is sent. 


There is both a limit on the total output that one 
task can send (MAXT0),t and a limit on the output 
one task can send before it is rolled out, pending 
the transfer of the output to the terminal or 
terminals CMLIM).T Also, the maximum output length 
for one SEND request is determined by the MAXWSt 
Installation parameter. 


A task can specify the status parameter in COBOL and 
FORTRAN or the r parameter in COMPASS so that the 
task will wait until the network acknowledges that 
the message has been delivered to the user* If 
recall is selected, any error detected on the output 
message causes the task performing the SEND request 
to be restarted. Therefore, tasks performing SEND 
requests with recall should check status and 

compensate for errors. Use of recall can simplify 

recovery since the task issuing the SEND request is 
informed of the problem at the first address after 
the SEND. When recall Is selected, the task is 
rolled out if the message length exceeds the MLIM 
installation parameter. Any data manager resources 
held by the task, such as locked records, remain 
assigned for the duration of the rollout • If 

reserving these resources for this period of time 
will Impact the performance of the application, 
tasks should release all file and record locks 

before executing the SEND request. 


If recall is not selected, ITASK is informed of the 
problem, rather than the task that issued the 
request. ITASK is informed because the issuing task 
may have already terminated when the message 
delivering problem is detected. 



username One- to seven-character user name, left-justified with binary zero fill. If the 

user name is binary zero, the terminal definition specified applies to the 
originating user. 

cc The number of 7-bit ASCII characters (at seven and one-half characters per word) 

is available In string + 2. Adding two is necessary because string begins in bit 
43. If no characters are specified in the string, cc should equal two. 


status An address of a word in which TAF returns the user name status in unnomalized 

floating-point format. The status contents Is zero if the user is not logged in 
and greater than zero if the request is processed normally. The task is aborted 
if the user name is not defined or if the data base for the user does not match 
the data of the originating user. 


string A string of 7-bit ASCII characters, in hexadecimal notation, left-justified in 

the field, defining the terminal characteristic. (Refer to the NAM/CCP Reference 
Manual for a list of these characteristics.) As an example, to change the cancel 
key to a +, the string CN*H- is written as 434E3D2B. string + n is the last word 
needed for the string. 


Figure 2-12. TERMDEF Parameter Table 


tRefer to the NOS 2 Installation Handbook (refer to the preface for the publication nimber). 
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FORTRAN 


The format of Che message on Che terminal depends on 
Che terminal class and the format effectors in the 
message* For example, on synchronous terminals the 
cursor for entering the next message to the host 
(upline) is always the first character of the line* 
On asynchronotis terminals the cursor follows the 
last character of output; this asstmes no format 
effectors are in the message* The NAM/CCP Reference 
Manual contains complete information on terminal 
protocols* 

The format is: 

COBOL 

ENTER ’*SEND" USING messageaddress username 

cease-flag output-flag block status length* 

The parameters are described in table 2-3* 


I NOTE I 


CALL SEND (messageaddress ,leng th,username, 
cease-flag.output-flag,block,status) 

The parameters are described in table 2-4* 

COMPASS 
SEND address 

address Address of a parameter table in 
the format shown in figure 
2-13* This figure and the 
parameters in table 2-5 should 
be used with table 2-6* This 
table shows Interrelationships 
between SEND parameters* 
Setting parameters shown in the 
top portion of table 2-6 results 
in the corresponding events 
shown In the bottom portion. 


Under COBOL, SEND must be enclosed in 

quotation marks, because SEND is a The entire four-word block must be present, even 

reserved word for that compiler* if the last three words are not used* 


Table 2-3* COBOL SEND Request Parameters (Sheet 1 of 2) 


Parameter 

Data Type 

Value 

Description 

messageaddress 

Ol-level display item 


Data item containing the message to be sent* For 7-blt 
ASCII character types, the message must have an end-of- 
llne byte of the single character US for all logical 
lines* (Refer to the NAM/CCP Reference Manual for NAM 
data formats.) The TAF SEND Interface supplies end-of- 
llne bytes for 6-blt display code character types only. 

username 

01-level display item, 
or computational-1 


Data item containing a one- to seven-character user 
name* If this parameter Is omitted or specified as 
COMP-1 VALUE ZERO, the message Is sent to the originat¬ 
ing terminal* This user name must be a name appearing 
in the NCTFl file and must be validated for the same 
data base as the sending task.t A user name consisting 
of the character P with binary zero fill cannot be 
specified. The user name can be binary zero or blank- 
filled. 

cease-flag 

Computational-1 


Task end flag* 



0, omitted 

The task continues after the message Is sent* 



1 

The task ends after the message is sent. 

tTasks associated with application Identifier SY can SEND to any valid TAF user* 
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Table 2-3. COBOL SEND Request Parameters (Sheet 2 of 2) 


Parameter 

Data Type 

Value 

Description 

output-flag 

Computational-I 


Application block type* Currently serves no function* 
Retained for compatibility with previous releases* 

block 

Computatioaal-1 


Application block number (ABN) data name* 



Nonzero 

TAF uses the value contained In the data name as the 
ABN* 



0 

TAF assigns the ABN and returns this as the value in 
this data name* 



Omitted 

TAF assigns the ABN, and the value is not returned* 

status 

Computatioaal-1 


Recall flag; this parameter applies only if the cease- 
flag is set to zero* 



0, omitted 

The task begins processing after the block Is transmit¬ 
ted to the network* 



Nonzero 

The task begins processing after the block has been de¬ 
livered to the user and acknowledgment is received* 
Each nonzero value Indicates the status of the block* 
The network function, subfunction, and description are 
given here* For all values other than 1, the block was 
not delivered to the user and the task must recover* 



1 

Block delivered (FC/ACK), 



2 

Block not delivered (INTR/USR/RC-1)* 



3 

User break 1 (INTR/USR/RC-1)* 



4 

User break 2 (INTR/USR/RC-1). 



10 

Terminal not logged in (CON/END)* 



11 

Correspondent unavailable or failed, line disconnect 
(CON/CB/RC-D* 

length 

Computatlonal-l | 


Length of the message in characters* This length 
should include end-of-llne bytes for 7-bit ASCII char¬ 
acter types* For 6-bit display code output, Che COBOL 
compiler-generated length Is used if the length param¬ 
eter is omitted* 
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Table 2-4• FORTRAN SEND Request Parameters (Sheet 1 of 2) 


Parameter 

Data Type 

Value 

Description 

messageaddress 

Hollerith or left- 
justified, zero fill 


Array name containing the message to be sent. For 
7-bit ASCII character types, the message must have an 
end-of-llne byte of the single character US for all 
logical lines* (Refer to the NAM/CCP Reference 
Manual for NAM data formats*) The TAF SEND interface 
supplies end-of-llne bytes for 6-bit display code 
character types only* 

length 

Integer 


Length of the message in characters* This length 
should Include the end-of-llne bytes for 7-bit ASCII 
character types* 

username 

Left-justified, 
zero or blank fill 
integer 


One- to seven-character user name* This must be a 
name appearing in the NCTFi file, which is validated 
for the same data base as the task issuing the send*t 

If this parameter is omitted or specified as binary 
zero, the message is sent to the originating terminal* 

cease-flag 

Integer 


Task end flag* 



0, omitted 

The task continues after the message is sent* 



1 

The task ends after the message is sent* 

output-flag 

Integer 


Application block type* Currently serves no function* 
Retained for compatibility with previous releases* 

block 

Integer 


Application block number* 



Nonzero 

TAF uses the value of this variable as the ABN* 



0 

TAP assigns the ABN and returns the value in this var¬ 
iable* For this parameter, you should enter an 
integer variable assigned the value zero Instead of 
entering zero, as follows: 




INTEGER ABN 

ABN-0 

CALL SEND(messageaddress^length^username/ 
cease-flag,output-flag^ABN,status) 



Omitted 

TAF assigns the ABN, and the value is not returned* 

status 

Unnormalized 
floating point 


Recall flag (applies only if cease-flag is set to 
zero* 



0, omitted 

The task begins processing after the block is trans¬ 
mitted to the network* 



Nonzero 

The task begins processing after the block has been 
delivered to the terminal and acknowledgment is 
received* Each nonzero value indicates the status of 
the block* The network function, subfunction, and 
description are given here* For all values other 
than 1, the block was not delivered to the terminal 
and the task must recover* 



1 

Block delivered (FC/ACK)* 



2 

Block not delivered (FC/NAK/RC«l). 



3 

User break 1 (INTR/USR/RC-1)* 



4 

User break 2 (INTR/USR/RC-1)* 

tTask associated with application identifier SY can SND to any valid TAP user* 
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Table 2-4, FORTRAN SEND Request Parameters (Sheet 2 of 2) 


I 



Parameter 

Data Type 

Value 

Description 



10 

Terminal not logged in (CON/END). 



II 

Correspondent unavailable or failed, line disconnect 


• 


(CON/CB/RCal). 


Table 2-5, COMPASS SEND Request Parameters (Sheet I of 2) 


Parameter 

Bits 

Value 

Description 

t 

59 


Terminal flag. 



0 

Message is sent to originating terminal. 



1 

Message is sent to specified user • 

c 

58 


Task cease flag. 



0 

The task cease is not performed. 



1 

The task cease is performed following the SEND request. 

0 

57 


No function. Retained for compatibility with previous releases. 

b 

56 


Return block flag. 



0 

If a is set to one, the task assigns the block number via the abn 
field. If a is set to zero, TAF assigns the block number, and the 
number is not returned in the block field. 



1 

TAF assigns the block number and returns this number in the block 
field. 

r 

55 


Recall flag. 



0 

TAF does not wait for the block to be delivered to the terminal. 



1 

TAF waits for the block to be delivered to the terminal. 

a 

54 


Application block header flag. 



0 

TAF generates the application block header but does it in Its own 
area without making use of or changing word 3 of the parameter table 
shown in figure 2-8. (Refer to the description of the BLDABH request 
for the default values TAF uses.) Because a BLDABH request is not 
available to COMPASS tasks, the header TAF supplies when a=>0 always 
has default values, except for a tic Influenced by numwords. 
Specifically, if a is set to zero, the task can only output in 6-bit 
display code, cannot use format effectors, cannot use auto-input 
mode, and cannot preset the application block number. 



1 

The task supplies the application block header. (The task supplies 
the ABH in the third word SEND parameter table shown in figure 2-8, 
with parameters shown in table 2-6.) 
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Table 2-5. COMPASS SEND Request Parameters (Sheet 2 of 2) 


Parameter 

Bits 

Value 

Description 

messageaddress 

47-30 


Address of message. For 6-bit display code character type, the 
message must contain an end-of-line byte from 12 to 66 bits of 
zero* For 7-blt ASCII characters, the message must have an end-of- 
line byte of the single character US for all logical lines in Che 
output block. (Refer to the NAM/CCP Host Application Programmers 
Reference Manual.) 

numwords 

17-0 


Number of words in the message. If the a field is set to one, this 
field is not used. The tic field must be used to specify the mes¬ 
sage length. The numwords field must contain the unit separator. 

username 

59-18 


User name from one to seven characters with binary zero fill. If 
the t field is set to one, this parameter must be specified. If 
the t field is set to zero, this field is Ignored. 

block 

17-0 


Application block number. If the b field is set to one, TAF 
returns the application block number in this field. 

abtt 

59-54 


Application block type. This parameter is ignored by TAF. It is 
retained for compatibility with previous systems. 



1 

Indicates that this is not the last data block of the message. 



2 

Indicates that this is the last or only data block of the message. 

abn t 

41-24 


Application block number. If the b field is set to one, TAF 
assigns and scores a value in the block field. If the b field is 
set to zero, this value is scored in block. 

act t 

23-20 


Application character type. 



2 

7-btt ASCII characters, seven and one-half per word. 


- 

3 

7-blt ASCII characters, right-justifled in 12-bit bytes, five per 
word. 



4 

6-biC display code characters, 10 per word. 

nfe t 

15 


Format effectors. 



0 

Format effectors appear in the SEND message. Refer to the NAM/CCP 

Host Application Programmers Reference Manual for information 
concerning format effectors. 



1 

No format effectors appear in the SEND message. 

xptt 

14 


Transparent bit. 



0 

Nontransparent data. IVT transforms are used. 




If the act field is set to two or three, IVT transforms are inhib¬ 
ited. If the act field is sec to four, this bit Is Ignored. 

almt 

12 


Auto-input mode. 



0 

No auto-input mode. 



1 

Auto-input mode enabled* 

tlct 

ll-O 


Text length in units specified by the act field. If an output 
block contains multiple logical lines, all logical lines must 
contain end-of-line bytes, which must be Included in the character 
count* 

status 

59-0 


Status of Che user name. This field is used only if the r field 
is set to one. The value of this field is a supervisory message 
returned by the network. (Refer to the NAM/CCP Host Application 
Programmers Reference Manual for a description of the supervisory 
messages.) 

tThese parameters apply only if the a 

field is set to one. 
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Figure 2-13* SEND Parameter Tablet 


RELSCB Request 

The RELSCB request releases all overflow 
communicatioo blocks tt to the system. After an 
RELSCB request Is processed, subsequent LOADCB 
requests return a status word of zero* 

The format Is: 

COBOL 

ENTER RELSCB. 


the user does not meet the specified criterion. For 
example, an application could use this to obtain a 
list of the users that are allowed to use a particu¬ 
lar data base by selecting the data base field to be 
searched for a certain name. 

If the task data base is not the same as the one 
being interrogated, then the list equals zero. 

The format is: 

COBOL 


There are no parameters. 

FORTRAN 

CALL RELSCB 

There are no parameters. 

COMPASS 

RELSCB 

There are no parameters. 


TSIM Request 

The TSIM request provides limited interrogation of 
the terminal status table. This table, in central 
memory, is derived from the network file (refer to 
section 9). The TSIM request can search four fields 
in the table. 

• Data base name field 

• User argument field 

• Communication line field 

• User name field 

The two-word TST entry of the users Chat meet a 
defined criterion (criterion) is returned to the 
user. The field specified by code Is examined in 
each terminal table entry by taking the logical 
product of Che field and mask to isolate a portion 
of the field. The logical difference of this 
product and criterion value is Chen obtained. If 
this result is zero, the terminal entry is placed in 
list. No action occurs if it Is not zero; that is. 


ENTER TSIM USING code mask criterion rlength 
list length. 


code 


Computational-1 item whose value 
indicates which field is to be 
searched: 

Value Field 

0 Data base name field. 

1 User argument field. 

2 Communication line 

field. 


3 User name field. 


mask Parameter whose value is taken as a 

binary mask. It is used in compil¬ 
ing the list of user names. 


criterion Criterion value for the search* 


rlength Computacional-l item whose value TAF 
sets to indicate the number of en¬ 
tries found* 

list Item in which TAF lists found en¬ 

tries. If zero or absent, no list 
is returned but rlength is given as 
the number of found entries. 

length Computational-1 item whose value 
indicates the number of words that 
list can hold* If zero or absent, 
no list is returned but rlength is 
given as the number of found 
entries* Only the lowest order L2 
bits of this value are used. 


tThe parameters are described in table 2-3. 
ttOescribed under LOADCB Request. 
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Table 2-6. COMPASS SEND Parameter Interrelationships 
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FORTRAN 


CALL TSIM(code,mask, c ri ter ion ,rl eng th ,list, 
length) 


code Integer whose value indicates 

which field is to be searched: 

Value Field 

0 Data base name field. 

1 User argument field. 

2 Communication line 
field. 


3 User name field. 


mask Parameter whose value is taken 

as a binary mask. It is used in 
compiling the list of user names* 


criterion Criterion value for the search* 


entries found* This value is 
also returned as a FORTRAN 
function value. 

list Name of an array in which TAF 

places a list of found entries. 
If zero or absent, no list is 
returned, but rlength is given 
as the number of found entries. 

length Integer variable whose value 

indicates the number of words 
that list can hold. If zero or 
absent, no list is returned, but 
rlength is given as the number 
of found entries. Only the 
lowest order 12 bits of this 
value are used* 


COMPASS 

XSIM address 


rlength Integer variable whose value TAF 
sets to Indicate the number of 


address Address of a parameter table in 
the format shown in figure 2-14. 


59 


47 


29 


17 


vtford 1 
word 2 

word 3 


code 


list 


length 


rlength 


mask 


code 


list 
length 

rlength 

mask 

criterion 


Integer whose value ixkdicates which field is to be searched: 

Value Field 

0 Data base name field. 

1 User argument field. 

2 Communication line field. 

3 User name field* 

Location of list to contain found entries. If zero or absent, no list is 
returned, but rlength is given as the number of found entries. 

Number of words that list can hold* If zero or absent, no list is returned, but 
rlength is given as the number of found entries. Only the lowest order 12 bits 
of this value are used. 

The address at which TAF returns the nimber of entries found. 

Value to be taken as a binary mask. It is used in compiling the list of user 
names. 

Criterion value for the search. 


Figure 2-14. TSIM Parameter Table 
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TARO Request 


The format is: 


The TARO request allows the task to manipulate the 
user argument field in the terminal status table 
entry of a particular user, (Refer to section 9 for 
further information.) The user argument field (24 
bits) is operated on in the following manner. The 
logical pr<^uct of the user argument field and the 
lower 24 bits of mask are taken; then Che logical 
difference of this result and value is determined. 
This value is placed in return and replaces the old 
user argument field. This allows the user to test a 
specific field to obtain its value and to establish 
a particular value In the field. For example, bit 1 
of the user argument field may be used to establish 
a terminal recovery condition. The TARO request 
operates in the following manner. 


Case 1: The request interrogates the user argument 
field and determines whether the recovery 
bit (bit 1) is set. The value of this bit 
in the user area is not changed and is 
placed in return. (Only bits 0 through 3 
are shown in this example.) 


COBOL 

ENTER TARO USING value mask username return. 


value Item whose value is a 24-bit 

value to be used to alter the 
user argument field. 

mask Parameter whose value is taken 

as a binary mask. Only the 
lowest 24 bits are used. 


username A 01-level item containing a 

one- to seven-character alpha¬ 
numeric user name. The user 
name can also be a 
computational-1 item containing 
a binary zero (designating the 
originating user). 

return Item whose value TAF sets to 

indicate the resultant user 
argument bits. 


log ical 

010 

user argument field 
of TST 

product 

010 

mask parameter 

logical 

010 


difference 

000 

value parameter 


010 

return value - new 
user argument field 

request sets 

the 

recovery bit. 

logical 

000 

user argument field 

product 

010 

mask parameter 

logical 

000 


difference 

010 

value parameter 


010 

return value - new 


user argument field 


Case 3: The request clears the recovery bit. 


logical 

010 

user argument field 

product 

000 

mask parameter 

logical 

000 


difference 

000 

value parameter 


000 

return value *» i 
user argunent field 


FORTRAN 


CAIL TAR0(value,mask,username,return) 


value Parameter whose 24-bit value is 

used to alter user arguments. 

mask Parameter whose value is taken 

as a binary mask. Only the 
lowest 24 bits are used. 


username Parameter whose value is a one- 

to seven-character alphanumeric 
user name, containing either 
blank or binary zero fill to a 
word boundary. If this 
parameter is omitted or is a 
binary zero, then the 
originating user is used. 

return Parameter in which TAF places 

the resultant user argument 
bits. This value is also 
optionally returned as the value 
of a FORTRAN function. 


COMPASS 


TARO address 


address Address of a parameter table in 
the format shown in figure 2-15. 
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110 Request 

FORTRAN 




The 1X0 request allows a task to change its own I/O 
limit as measured in RA+1 calls from the task. Any 
request given in this manual or any data manager 
request is considered an BA-hl call. The default 
value is 320 calls. 

CALL 110<nio) 

nio 

Integer 
the new 

t^ose value 
I/O limit. 

specifies 

The format of the request is: 

COBOL 

COMPASS 




ENTER no USING nlo. 

no address 




nio Computational-1 item whose value 

specifies the new I/O limit. 

address 

Address of a parameter cable in 
the format shown in figure 2-16. 



username One- to seven-character user name, left-justified with binary zero fill, for 

which the operation is performed* If username is a binary zero, then the 
originating user is used. 

return ' Location in which to place the resultant user argisnent bits. 


value 24-bit value to be used to alter the user argument field. 

mask Value to be taken as a binary mask. Only the lowest 24 bits are used. 


Figure 2-15. tAKO Parameter Table 
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BWAITINP Request (COMPASS Only) 

The BWAITINP request allows a task to move data from 
a terminal to a task field locatione This location 
has the same format as the communication block 
(refer to figure 2-1). The request is processed the 
same as a WAITINP request , except that when the 
terminal data is moved to the specified location, it 
is moved to the area specified by the supplied 
parameter (address), not the first word address of 
the task (as In the WAITINP request). The first 
word address is not changed by the execution of this 
request. 


The format is: 

BWAITINP address 

address Address of first word of the 
storage area where the terminal 
data is to be moved. 

TAP does not pass this terminal data to tasks called 
with the CALLTSK and CALLRTN requests* 


TPSTAT Request (COMPASS Only) 

The TPSTAT request is retained for compatibility 
with previous releases of TAP* It was used to 
enable a task to determine under which of two 
terminal subsystems the task was running. Now, all 
the tasks run under NAM. Therefore, the request 
always returns a 1. 


The format is: 

TPSTAT address 

address Address containing a 1 in bit 0 
to indicate NAM Is active. 


BEGIN Request 

The BEGIN request allows a task to specify the area 
where the terminal input data is to be placed, if an 
area other than the first word address of the task 
field length is desired* It supports programming 
languages that do not reserve the first word address 
of the task for the conmon block that is used for 
the communication block. The task must be installed 
in the appropriate task library with the (solicited) 
input directive, because the default is 
unsolicited. If task chains are involved, the 
calling task must issue a BEGIN request before 
resuming execution of the original task, because the 
calling task must be able to obtain the 
communication block containing the returned data 
from the called task. The returned communication 
block in solicited mode is in the same form as in 
unsolicited mode. Unless there is a specific need 
for this request, its use is not recommended because 
more execution overhead is required to support the 
secondary load request. 


The format is: 

COBOL 

ENTER BEGIN USING buffer. 

buffer A 01-level item identifying the 

user-defined buffer area. 

FORTRAN 

CALL BEGIN(buffer) 

buffer An array name identifying the 

user-defined buffer area. 

CCMPASS 
BEGIN address 

address Address of the user-defined 

buffer area. 

TASK CONTROL REQUESTS 

These requests are used for task control. 

• CEASE 

End a task. 

• ITL 

Set a task time limit. 

• LOGT 

Log a terminal out of TAF. 

• KPOINT 

Initiate execution of K display commands. 

• WAIT 

Suspend processing for a given amount of 
time* 


CEASE Request 

The CEASE request provides task end processing and 
transaction completion processing. If a 

predetermined task list exists for the chain (that 
is, subsequent tasks have been requested for 
scheduling, or the CEASE is a return from a CALLRTN 
request), no special processing occurs on a CEASE 
request from a task. Ifowever, if the request is 
from the final task in the chain, the transaction 
executive releases all communication blocks and 
notifies the data manager that updated records 
should be replaced on the data base* The one 
exception to this procedure occurs if a task selects 
an abnormal CEASE by use of an optional parameter. 

A task that terminates In this manner is 
automatically the final task in the chain. After an 
abnormal CEASE occurs, all communication blocks are 
released and records updated by the task but not yet 
updated on the data base are not replaced on the 
data base. 
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The format Is: 

COBOL 

ENTER CEASE USING a. 


a Computational-* 1 
indicates the type 

a 

0 

1 

-I 

217-1 > a > 1 

-1 > a > -(217-1) 

Any other value 
results and should 


item whose value 
of CEASE selected: 

Type of CEASE 

Normal CEASE. 

Abnormal CEASE with¬ 
out memory dump. 

Normal CEASE and ter¬ 
minal remains locked. 

Abnormal CEASE with 
memory dump.t 

Reserved for CDC. 

i produce undefined 
not be used. 


a 

217-1 > a > 1 
-1 > a > -(217-1) 


Type of CEASE 

Abnormal CEASE with 
memory dump.t 

Reserved for CDC. 


Any other values produce undefined 
results and should not be used. 


ITL Request 

The ITL request allows a task to set the time limit 
for the task to a new value. The time limit is 
expressed in exchange jump time units (that is, the 
number of times a task executed its full time slice 
without Interruption). In addition, each call to 
this function decreases the CPU priority of the task 
by 1 until the lower limit of priority is reached to 
ensure good service to other tasks. The time limit 
default value is a product of two Installation 
parameters. The released value is I *12 CPU 
seconds. If this is exceeded, the task aborts and 
the message TIME LIMIT EXCEEDED is issued to the 
terminal. 


FORTRAN 


The format is: 


CALL CEASB(a) 


COBOL 


a Integer whose value indicates the type 
of CEASE selected: 

a Type of CEASE 


ENTER ITL USING ntm. 

ntm Computational-1 item whose value 

specifies the new time limit. 


0 


Normal CEASE. 

Abnormal CEASE with¬ 
out memory dump. 


FORTRAN 
CALL ITL(nta) 


-1 


Normal CEASE and ter¬ 
minal remains locked. 


2l7-i > a > 1 
-1 > a > -(217-1) 


Abnormal CEASE with 
memory dump.t 

Reserved for CDC. 


ntm Integer whose value specifies the 

new time limit. 


COMPASS 
ITL address 


Any other values produce undefined address Address of a parameter table in 

results and should not be used. the format shown in figure 2-17. 


COMPASS 
CEASE a 

a Integer whose value indicates the type 
of CEASE selected: 

a Type of CEASE 

0 Normal CEASE. 


LOGT Request (COMPASS Only) 

The LOGT request logs out a terminal from TAF and 
returns it to nontransaction mode. The terminal can 
then access other interactive applications. A 
system task is provided using this request. (Refer 
to System Tasks in section 11.) 

The format is: 


I 

-1 


Abnormal CEASE with¬ 
out memory dump. 

Normal CEASE and ter¬ 
minal remains locked. 


COMPASS 

LOGT 

There are no parameters 


tDumps are identified by the transaction subsystem user name or by the appropriate DSDUMP parameter (refer to 
section 6). 
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KPOtNT Request 

The KPOINT request allows a task to ialtlate 
execution of any K display command. Section 6 
describes three K display commands: K.DUMP, 

K.DUMPLIM, and K.DSDUMP. 


K display commands are normally issued from the 
system console to communicate with and to request 
specific actions of TAP. K display commands should 
be issued with care and then only when the results 
of the command are well-defined. 


When a task issues a K display command, the prefix 
K. is omitted. For example, the entry from the con¬ 
sole is K.DUMP., but the same command issued from a 
task is DUMP. 


All K display commands, except K.DUMP, require that 
the calling task be on the system task library. Any 
task can issue the K.DUMP command. 

The format is: 

COBOL 

BNTER KPOINT USING address. 

address 01-level name of the character 
string (K display command). The 
length of the character string 
cannot exceed 80 characters. The 
string must begin on a word 
boundary and must be terminated by 
a period or a right parenthesis; 
the exception is the K.MESSAGE 
command, which must be terminated 
by 6 bits of zeros after either a 
period or a right parenthesis. 


FORTRAN 

CALL KP0INT(address) 

address Address of the character string (K 
display command). The length of 
the character string cannot exceed 
80 characters. The string must 
begin on a word boundary and must 
be terminated by a period or a 
right parenthesis; the exception 
is the K.MESSAGE command, which 
must be terminated by 6 bits of 


zeros after either a period or a 
right parenthesis. 


COMPASS 

KPOINT address 

address Address of the character string (K 
display command). The length of 
the character string cannot exceed 
80 characters. The string must be¬ 
gin on a word boundary and must be 
terminated by a period or a right 
parenthesis; the exception is the 
K.MESSAGE command, which must be 
terminated by 6 bits of zeros after 
either a period or a right paren¬ 
thesis. 


WAIT Request 

The WAIT request allows tasks to make TAP suspend 
processing for a specified number of seconds (0 to 
3600). The transaction must have no outstanding 
data manager requests at the time a WAIT request is 
issued. 

The format is: 

COBOL 

ENTER WAIT USING time. 

time A computational-2 data Item indi¬ 

cating the number of seconds for 
which processing is to be suspend¬ 
ed. If unspecified or out of 
range, the task is aborted. Only 
the Integer portion is significant. 


FORTRAN 

CALL WAIT(tlme) 

time A real number or variable indicat¬ 

ing the number of seconds for which 
processing is to be suspended. If 
unspecified or out of range, the 
task is aborted. Only the Integer 
portion Is significant. 
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COMPASS 


TASK UTIUTY REQUESTS 


WAIT address 

address The address of a word specifying the 
number of seconds (N) for which 
processing Is to be suspended* The 
word has the form 48/0,I2/N. If 
unspecified or out of range, the 
task Is aborted* 


The following task, utility requests provide capabili¬ 
ties for the FORTRAN and COBOL user, some of which 
are difficult to do because they are at the bit 
level• 

• LOGIN 

Determine If a specified user is logged In* 

• EXTRACT 

Extract a bit string from a word* 

• INSERT 

Insert a bit string into a word* 
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LOGIN Request 

The LOGIN request allows a task to determine If a 
specified user Is logged In before it Issues a SEND 
request to that user. TAF aborts a task chat Issues 
a SEND request without recall to a user who is not 
logged In. 


I NOTE~| 

It is possible for the receiving user 
to log out after the task Issues a 
LOGIN request and before the task 
issues a SEND request* Therefore, it 
is reconmended that the task issue 
the SEND request soon after issuing 
the LOGIN request. 


The format is: 

COBOL 

ENTER LOGIN USING username status. 

username A one- to seven-character alpha¬ 

numeric user name, left-justi¬ 
fied. A binary zero specifies 

the user associated with the 

transaction that is running. 

status Address of the location to 

contain the returned status. 
The format of the returned 

status is computetional-1* 
Values for status are: 

0 User not logged in* 

1 User logged in* 


FORTRAN 

CALL L0G1N(username,status) 

username A one- to seven-character alpha- 
nimeric user name, left-justi¬ 
fied. Possible forms are nHf 
and nLf (refer Co the FORTRAN 
Extended 4 Reference Manual). A 
binary zero specifies the user 

associated with the transaction 
that is running. 

status Address of the location to 

contain the returned status. 
The format of Che returned 
status is integer. Values for 

status are: 

0 User not logged in. 

1 User logged in. 


EXTRACT Request 

The EXTRACT request allows a task to extract a bit 
string from a word and move it to another word, 
right-justified. For instance, the EXTRACT request 
can be used to check fields in the terminal status 
table or the communication block. 

Tn the following request formats, if n is not within 
the specified range, if bbp plus 1 minus n is less 
than 0, or if there are any other errors in the 
parameters, TAF aborts the task and issues the 
following message* 

TASK REQUEST ARGUMENT ERROR. 

The format is: 

COBOL 

ENTER EXTRACT USING loci loc2 bbp n. 

loci Data name of the source field. 

Any data type is allowed, loci 
must begin on a word boundary. 

loc2 Data name of the compute Clonal-1 

destination field. The bit 
string is right-justified in 

this field. 

bbp Beginning bit position of field 

loci; this is the leftmost bit 

of Che field. Bits are numbered 
59 through 0. 

n Number of bits to extract; the 

range of values for n is 1 to 
59, inclusive. The format of n 
must be computational-I. 

FORTRAN 

CALL EXrRACT(locl,loc2,bbp,n) 

loci Name of the integer source field. 

loc2 Name of the integer destination 

field. The bit string is right- 
justified in this field. 

bbp Beginning bit position of field 

loci; this is the leftmost bit 

of the field. Bits are numbered 
59 through 0. 

n Number of bits to extract; the 

range of values for n is 1 to 
59, inclusive. n must be 
integer type. 

The COBOL STRING and UNSTRING statements also 
provide capabilities for manipulating character- 
aligned data. The EXTRACT request should be used 
only when Che use of these COBOL statements is 

impossible or inconvenient. 
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INSERT Request 

The INSERT request allows a task to insert a bit 
string into a word* For instance, the INSERT 
request can be used to set fields in the terminal 
status table* 


In the following formats, if n is not within the 
specified range, if bbp plus 1 minus n is less than 
0, or if there are any other errors in the 
parameters, T^ aborts the task and issues the 
following message* 


TASK REQUEST ARGUMENT ERROR* 


The format is: 

COBOL 

ENTER INSERT USING loci loc2 bbp n. 

loci Data name of the computational-1 

source field* The bit string must 
be right-Justified In this field. 

loc2 Data name of the destination field* 
Any data type is allowed* loc2 must 
begin on a word boundary* 

bbp Beginning bit position of field 

loc2; this is the leftmost bit of 
the field. Bits are numbered 59 
through 0* 

n Number of bits to insert; the range 

of values for n is 1 to 59, 
inclusive* The format of n must be 
computetional-1* 


FORTRAN 

CALL INSERT(locl,loc2,bbp,n) 

loci Name of the integer source field* 



The bit 


string 

must 

be 


right-justified 

in this field* 


loc2 

Name of 

the 

integer 

destination 


field* 





bbp 

Beginning 

bit 

position 

of 

field 


loc2; this is the leftmost bit of 
the field* Bits are numbered 59 
through 0* 

n Number of bits to Insert; the range 

of values for n is 1 to 59, 
inclusive* n must be integer type* 


The COBOL STRING and UNSTRING statements also 
provide capabilities for manipulating character- 
aligned data* The INSERT request should be used 
only when the use of these COBOL statements is 
impossible or inconvenient. 


APPLICATION RECOVERY REQUESTS 


The following task requests 

are 

for 

use 

in 

recoverable 

transactions* 

All 

are 

for 

use 

by 

applications 
system tasks« 

tasks although 

some 

are 

also 

used 

by 


• RERUN 


Restarts 

terminal 

a run 
input* 

unit 

using 

the initial 

• RGET 

Retrieves 

recovery 

data 

file (CRF) 

from 

a 

the 

communication 


• RPUT 


Places data on the communication recovery 
file* 

• RSECURE 

Retrieves a message previously saved on the 
communication recovery file by a SECURE 
request * 

• SECURE 

Signals the completion of a transaction's 
work and saves a message on the recovery 
file to be sent to the terminal when the run 
unit ceases* 

• TSTAT 

Returns the status of one or more specified 
objects• 

Refer to section 7 for an overview of the recovery 
process from the applications programmer's 
perspective* Refer to the applicable data manager 
reference manual (CDCS, TAF/CRM, or TOTAL) for 
requests associated with data base recovery. 


RERUN Request 

The RERUN request causes the initial terminal input 
for a rerunnable run unit to be resubmitted to the 
transaction system* The input comes from the 
communication recovery file* The actions that occur 
as a result of RERUN are: 

1* The recovery status is set to zero so that 
the recovery task will not be scheduled. 

2* The restart status (TSTAT with keyword 
RESTART) is set to one. 

3* A termination is processed for the run unit 
and ITASK is called to rerun the run unit. 

Transactions using this request must take care to 
avoid entering an infinite loop if the RERUN results 
from an error condition. 
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The format is: 


COBOL 

ENTER RERUN USING status. 

status A computatlonal-1 data item 

whose value Is set by TAF to 
indicate the status of the 
request. The values are: 



0 

No errors. 




29 

Recovery is 
stalled. 

not 

in- 


33 

Run unit is 
runnable• 

not 

re- 

FORTRAN 





CALL R^UN (status) 





status An integer variable in 

TAF will return a status, 
values are: 

whlch 

The 


0 

No errors. 




29 

Recovery is 
stalled. 

not 

In- 


33 

Run unit is 

not 

re- 


runnable. 


RPUT and RGET Requests 

The RPUT request allows a task to put application- 
dependent data on the communication recovery file. 
The RGET request allows the task to retrieve the 
data placed on the recovery file by an RPUT. The 
length of the data In each request and the number of 
slots for data on the recovery file is specified at 
TAF Initialization on the RECOVER statement in the 
TCF (refer to section 4). TAF maintains the data on 
a user name basis. TAF does not modify the user 
data unless the communication recovery file is 
initialized. These requests may be used by any task 
when TAF automatic recovery is installed. 

The format is: 

COBOL 

ENTER "RPUT** USING message »lndex[ ,8 tat us ,message- 
length ,3Ct]• 

ENTER '*RGET*' USING message,index,status ^essage- 
length(,act]* 

message An 01-level data item that 

contains the message. This is 
an input parameter for RPUT and 
an output parameter for RGET. 

index A computational-1 data Item 

indicating the index for the 

recovery record. Index 1 

points to the first record in 

user area of the communication 
recovery file; index 2 points 
to the second record In user 


area of the communication 
recovery file, and so on. This 
parameter is input for both 
RPUT and RGET. The maximum 
value of index is the value of 
the number parameter in the 
RECOVER statement in the TCF. 

status A computetional-1 data item 

whose value is set by TAF to 
indicate the status of the 
request. The values are: 

0 No errors. 

19 The index is outside of 
the user recovery file 
message area (RPUT 
only). 

20 No message (RGET only). 

21 The message does not 
fit in the recovery 
file message area (RPUT 
only)« 

22 The message does not 
fit in the user message 
area (RGET only). 

23 Incorrect application 
character type (act). 

28 The RGET act is not 
equal to the RPUT act. 

29 TAF automatic recovery 
is not installed. 

message- A compute tional-1 data item 

length Indicating the length of the 

message in the message units 
specified by the act parameter. 
This parameter is required when 
using message units other than 
6-bit display code. This Is an 
input parameter for RPUT. For 
RGET, the user sets the message- 
length of the area to receive 
the message. Upon completion 
of RGET, TAF places the length 
of the message in message- 
length. 

act A computational-1 data item 

Indicating the application 
character type. The type is 
the same as for NAM. This is 
an input parameter. The values 
are: 

2 7-bit ASCII characters, 
seven and one-half per 
word. 

3 7-bit ASCII characters, 
right-justified in 12- 
bit bytes, five per 
word. 

4 6-blt display code char¬ 
acters, 10 per word. 

This Is the default 
value. 
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FC^TRAN 

CALL RPUT(message,index,status ,message-length 
[ ,act]) 

CALL RGETCmessage,index,status ,message-length 
[,actl) 

message The name of an array that 

contains the message. This is 
an input parameter for RFUT and 
output parameter for RGET. 

index An integer variable indicating 

the index for recovery record. 
Index 1 points to the first 
record in user area of the 
communication recovery file; 
index 2 points to the second 
record in user area of the 
communication recovery file, 
and so on. This parameter Is 
input for both RPUT and RGET. 
The maximim value of index is 
the value of the number 
parameter in the RECOVER 
statement in the TCF. 


status An Integer variable whose value 

is set by TAF to indicate the 
status of the request. The 
values are: 


act An Integer variable Indicating 

the application character 
type. The type is the same as 
for NAM. This is an Input 
parameter. The values are: 

2 7-bit ASCII characters, 
seven and one-half per 
word. 

3 7-bit ASCII characters, 
right-justified in 12- 
bit bytes, five per 
word. 

4 6-bit display code 

characters, 10 per 
word. This is the 

default value. 


RSECURE Request 

The RSECURE request allows a recovery task to obtain 
a message previously saved on the communication 
recovery file by a SECURE request. After obtaining 
the message, the task would normally send the 
message to the appropriate terminal. Any task may 
use this request if automatic recovery has been 
Installed with TAF. 

The format is: 


0 No errors. 


COBOL 


19 The index Is outside of 
the user recovery area. 

20 No message (RGET only). 

21 The message does not 
fit In the recovery 
file message area (RPUT 
only). 

22 The message does not 
fit in the user message 
area (RGET only). 

23 Incorrect application 
character type (act). 


ENTER "RSECURE” USING message,status , 
message-length ,ac t,format-effec tor, 
transparent-mode. 

message An 01-level data item that 

contains the message. This is 

an output parameter. 

status A computational-1 data item 

whose value is set by TAF to 
indicate the status of the 

request• The values are: 

0 No errors. 

20 No message. 


28 The RGET act is not 
equal to the RPUT act. 

29 TAF automatic recovery 
is not installed. 


22 The message does not 

fit in the user message 
area. 

29 Recovery is not in¬ 

stalled. 


message- An Integer variable indicating 

length the length of message in the 

message units specified by the 
act parameter. This is an 
input parameter for RPUT. For 
RGET, the user sets the message- 
length of the area to receive 
the message. Upon completion 
of the request, TAF returns the 
message-length as recorded on 
the communication recovery file. 


message- A computational-1 data item 
length indicating the length of 

message in the message units 
specified by the act 
parameter. Before issuing the 
request, the user sets the 
message-length area in the 
task. Upon completion of the 
request, TAF returns the 
message-length as recorded on 
the communication recovery file. 
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act A computational-1 data Item 

Indicating the application 
character type. The type is 
the same as for NAM. Before 
issuing the request, the user 
sets the act. Upon completion 
of the request, TAF returns the 
act as recorded on the recovery 
file. The values are: 

2 7-blt ASCII characters, 
seven and one-half per 
word, 

3 7-bit ASCII characters, 
right-justified in 12- 
bit bytes, five per 
word, 

4 6-blt display code 

characters, 10 per 

word. This is the 
default value, 

format- A compute tional-1 data It^ 

effector indicating format effector 

usage. The values are: 

0 Format effectors appear 
in the message. 

1 No format effectors 

appear in the message, 

transpar- A computetlonal-1 data item 

ent-fflode indicating transparent mode 

usage. Default is nontranspar¬ 
ent mode. The values are: 

0 Nontransparent data. 
Interactive virtual 

terminal transforms are 
used, 

1 Transparent data. IVT 
transforms are inhib¬ 
ited, 

FORTRAN 

CALL RSECUR£(message,status,message-length, act, 
format-effector,transparent-mode) 

message The name of an array that 

contains the message. This is 
an output parameter, 

status An integer variable whose value 

is set by TAF to indicate the 
status of the request. The 
values are: 

0 No errors, 

20 No message. 

22 The message does not 
fit in the user message 
area, 

29 Recovery is not in¬ 
stalled. 


message- An Integer variable indicating 

length the length of the message in 

message units specified by the 

act parameter. Before issuing 
the request, the user sets the 
message-length area in the 
task. Upon completion of the 
request, TAF returns the 
message length as recorded on 
the communication recovery file. 

act An integer variable indicating 

the application character 

type. The type is the same as 

NAM* Before issuing the 
request, the user sets the 
act. Upon completion of the 

request, TAF returns the act as 
recorded on the recovery file. 
The values are: 

2 7-bit ASCII characters, 

seven and one-half per 

word* 

3 7-bit ASCII characters, 

right-justified in 12- 

bit bytes, five per 
word. 

4 6-bit display code 

characters, 10 per 
word. This is the 

default value* 

format- An integer variable indicating 

effector format effector usage. The 

values are: 

0 Format effectors appear 

in the message, 

1 No format effectors 

appear in the message. 

transpar- An integer variable indicating 

ent-mode transparent mode usage. The 

values are: 

0 Nontransparent data. 

Interactive virtual 

terminal transforms are 
used. 

1 Transparent data. IVT 

transforms are inhib¬ 
ited. 


SECURE Request 

The SECURE request tells the transaction executive 
that the work of the run unit is complete. All that 
remains is to commit the data base and end the run 
unit. The SECURE request Includes a terminal 
confirmation message. This message will be sent at 
the run unit end time (normal CEASE). If the commit 
request fails, the task may RERUN the run unit or 
issue a CEASE request with abnormal termination. In 
either case, the SECURE message will not be sent. 
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TAF records the message associated with SECUKE on 
permanent storage so that the message can be 
delivered In spite of system or terminal failures. 
If no failures occur, the message will be sent from 
the task^s SECURE message area. This means that the 
SECURE, data base commit, and CEASE must occur In 
the same task. TAF assumes that the message has 
been acknowledged by the terminal operator when the 
operator enters the next transaction Input. The 
SECURE message may appear twice If recovery Is done 
after a failure, but It Is guaranteed to appear at 
least once. TAF also saves the NAM application 
block header with the message so that It will be 
sent with the correct character type and mode. Only 
the last SECURE message Is saved per run unit. Any 
task may use this request If recovery has been 
installed with TAF; however. If the run unit Is not 
recoverable, the SECURE message will not be Issued 
to the terminal upon recovery (only at Initial CEASE 
time). 

For a BTRAN run unit the message Is recorded on the 
communication recovery file but no message Is sent 
to the term Inal/username. The RECOVER statement 
maxlmumslze parameter specifies the message size 
that can be recorded on the communication recovery 
file. 

The format of the message on the terminal depends on 
the terminal class and the format effectors in the 
message. Refer to the SEND request description 
earlier In this section for more Information. 

The format Is: 

COBOL 

ENTER ''SECURE" USING me s sage, s tat us [ ,mes8age* 
length,act,format*effeetor,transparent-mode]• 

message A Ol-level data Item that 

contains the message. This Is 

an input parameter. 

status A computatlonal-1 data Item 

whose value is set by TAF to 
indicate the status of the 

request. The values are; 

0 No errors. 

21 The message Is too 

large to fit in TAF's 
communication recovery 
file. Refer to the 

RECOVER statement maxl¬ 
mumslze parameter. 

23 Incorrect application 
character type. 

24 Incorrect format- 

effector value. 

25 Incorrect transparent- 
mode value. 

26 The message exceeds the 
maximum length for SEND. 

27 The message exceeds the 
maxlmim length for a 
run unit. 

29 TAF automatic recovery 
is not installed. 


message- A computetional-l data item 
length Indicating the length of the 

message In the message units 
specified by the act 
parameter. This Is an Input 
parameter. It Is required when 
the act parameter does not 
specify display. 


act A computational-1 data item 

Indicating the application 
character type. The type Is 
the same as for NAM. ^Is Is 
an Input parameter. The values 
are: 

2 7-bit ASCII characters, 
seven and one-half per 
word. 

3 7-blt ASCII characters, 
right-justified in 12- 
bit bytes, five per 
word. 

4 6-bit display code 

characters, 10 per 
word. This is the 

default value. 


format- A computational-1 data item 

effector Indicating format effector 
usage* This is an optional 
parameter* It Is necessary 
only If format effectors are 
used. Ihe default Is no format 
effectors* The values are: 

0 Format effectors appear 
in the message. 

1 No format effectors 
appear In the message. 


transpar- A computational-1 data item 
ent-mode indicating transparent mode 
usage. This is an optional 
parameter. It is necessary 
only if transparent mode is 
used* The default Is 

nontransparent mode. The 
values are: 

0 Nontransparent data. 
Interactive virtual 

terminal transforms are 
used* 

1 Transparent data. IVT 
transforms are inhib¬ 
ited. 


FORTRAN 

CALL SECURE (message,status,message-length 
[ ,act ,format-effector,transparent-mode]) 

message The name of an array that 

contains the message. This is 
an input parameter* 
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status 


message- 

length 


act 


format- 

effector 


An integer variable whose value 
is set by TAF to indicate the 
status of the request. The 
values are: 

0 No errors• 

21 The message is too large 
to fit in the communica¬ 
tion recovery file. 
Refer to the RECOVER 
statement maximumsize 
parameter. 

23 Incorrect application 
character type. 

24 Incorrect format effect¬ 
or value* 

25 Incorrect transparent¬ 
mode value. 

26 The message exceeds the 
maximun length for SEND. 


transpar- An integer variable indicating 

ent-mode transparent mode usage. This 

is an optional parameter. It 
is necessary only if 
transparent mode is used. The 
default is nontransparent 
mode. The values are: 

0 Nontransparent data• 
Interactive virtual 

terminal transforms are 
used* 

1 Transparent data. IVT 
transforms are inhib¬ 
ited. 


TSTAT Request 

The TSTAT request returns information about the 
current user or run unit. It is used by both system 
tasks and applications (user) tasks. 


27 The message exceeds the The format is: 
maximum length for a 
run unit. COBOL 


29 TAF automatic recovery 
is not installed. 


ENTER "TSTAT** USING status,keyword^,valuei, 
keyword|i ,value[^ • 


An integer variable indicating 
the length of the message in 
the message units specified by 
the act parameter. This is an 
input parameter. 

An integer variable indicating 
the application character 
type. The type is the same as 
for NAH. This is an Input 
parameter. The values are; 

2 7-bit ASCII characters, 
seven and one-half per 
word. 

3 7-bit ASCII characters, 
right-justified 12-bit 
bytes, five per word• 


status A compute tional-1 data item 

whose value is set by TAF to 
indicate the status of the 

request. The values are: 

0 No errors. 

12 The keyword speci¬ 

fied requires TAF 
automatic recov¬ 

ery. TAF automatic 
recovery is not 
installed. 

13 End of NEXT proc¬ 
essing. 

14 USER is not defined 
in the network file. 


4 6-bit display code 

characters, 10 per 

word* This is the 
default value* 

An integer variable indicating 
format effector usage. This is 
an optional parameter. It is 
necessary only if format effec¬ 
tors are used. The default is 
no format effectors. The 

values are: 

0 Format effectors appear 

in the message. 

1 No format effectors 
appear in the message. 


400+i keyword^ is invalid. 

keywordAn 01-level item that contains 
a one- to seven-character 
keyword for which a value is 
desired. The keyword must be 
left-justifled and blank- 
filled. Refer to table 2-7 for 
keyword definitions. 

valueA data item to which TAF returns 
the value for the corresponding 
keyword. The keyword^ and 
value^ fields must appear in 
pairs. For USER, NEXT, OLDID, 
and NEWID usage is display. For 
all other TSTAT keywords, usage 
is computational-1. 
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FORTRAN 


TSTAT System Task Keywords 


CALL TSTAT(status .keyword^,valuej,.••.keyword^, 

valuejj) 

status An Integer variable whose value 

Is set by TAF to Indicate the 
status of the request* The 
values are: 

0 No errors• 

12 The keyword speci¬ 

fied requires lAF 
autoaatlc recov¬ 
ery* TAF automatic 

recovery is not 

installed. 

13 End of NEXT proc¬ 
essing • 

14 USER is not defined 

in the network file. 

400+1 keywordis Invalid. 

keyword^ A variable that contains a one- 
to seven-character left-jus- 
tlfied keyword for which a 

value is desired. The keyword 
must be blank-filled. Refer to 
table 2-7 for keyword 
definitions • 

valuejr A variable field to which TAF 

returns the value of the de¬ 

sired keyword. The keyword^ 
and value must appear in 
pairs* For USER, NEXT, OLDID, 

and NEWXD value^ is character 
data. For all other TSTAT 

keywords, value^^ is an 
Integer* 

Some TSTAT keywords (both as COBOL and FORTRAN 
parameters) are meant for user tasks and others are 
meant for system tasks, such as BTASK, CTASK, and 
RTASK. 

TSTAT User Task Keywords 

• Keywords RESTART, OLDID, and NEWXD are meant 
for use by application tasks that use 
multiple data manager begin-commit sequences 
to determine If the run unit is in a 
restarted state and, if so, where to begin 
processing* 

• Keywords STEP, TRAN, OLDIN, NEWID, CRM, and 
CDCS are used by RTASK during terminal 
log in/relog in to determine if a run unit 
requires rerun* The SEQ (sequence number) 
returned is the transaction sequence number 
that was first assigned to the run unit* 
RTASK can be either a system task or a user 
task* 


• Keywords NEXT, STEP, TRAN, OLDID, NEWID are 
used by BTASK to read sequentially the 
communication recovery file to find batch 
(BTRAN) run units that require rerunning* 
BTASK uses the SRERUN request with username 
to rerun BTRAN run units* 


SYSTEM TASK RECOVERY REQUESTS 

Applications programmers can skip this subsection 
since all the requests documented here are available 
only to system tasks (that is, tasks residing on the 
system task library)* Recovery requests that are for 
use by both system tasks and application tasks are 
doctmented under Application Recovery Bequests ear¬ 
lier in this section. Refer to section 8 for an 
overview of the recovery process from the data admin¬ 
istrator's perspective. Refer to the applicable data 
manager reference manual (CDCS, TAF/CRM, or TOTAL) 
for requests associated with data base recovery. The 
following task requests are used by system tasks for 
transaction recovery* 

• CALLTRN 

Initiates a run unit* 

• SRERUN 

Resubmits initial terminal input for a rerun- 
nable run unit* 

• TINVOKE 

Returns or specifies a system identifier for 
begin-commit sequences in this job* 

• WSTAT 

Records information needed for recovery 
processing* 


CAUTRN Request 

The CALLTRN request causes the initiation of a run 
unit* It is available only to the system task ITASK* 
The actions that occur as a result of CALLTRN are: 

1. ITASK ceases* If an error condition is de¬ 
tected, an error message is issued to the 
terminal via MSABT. 

2* The initial terminal input is logged on the 
CRF if the transaction Is recoverable* The 
transaction will not be scheduled for execu¬ 
tion until this circular input-output (CIO) 
operation is complete* 

3* If the transaction Initiated is recoverable, 
the commitment history of the previous recov¬ 
erable run unit for this user Is released. 
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Table 2-7. TSTAT Keyword Descriptions 


Description 


Return status for the user/terminal specified in value* If USER or NEXT 
is not specified, then the request refers to the originating terminal/ 
user. Only one of USER/NEXT can be specified in a single TSTAT request. 
Reserved for tasks on system task library* 

Return the next user from the communication recovery fileCs)* NEXT is 
available only to system tasks* When NEXT is specified, all other key¬ 
words will refer to the next user* Only one of USER/NEXT can be specified 
in a single TSTAT request* 

Return the transaction sequence number for specified user* 

Run unit or job step. 

Nonrecoverable run unit or job input* 

CDCS down* This applies only to a recoverable run unit* 

Normal transaction CEASE or job end* Present only for BTRAN or TAF/CRM 
batch concurrency jobs* 

Task or job abort* 

Run unit is no longer rerunnable* This occurs when an I/O error is 
detected and the data cannot be recovered for the user* 

Recoverable run unit or job input* 

CRM begin-cooBnit ids are logged. 

NAM down. This applies only to a recoverable run unit. 

Run unit type* 

Terminal user* 

BTRAN user jobs* 

TAF/CRM user job* 

CRM usage* 

CRM may not be used by the transaction. 

CRM may be used by the transaction* 

CDCS usage* 

CDCS may not be used by the transaction. 

CDCS may be used by the transaction* 

Run unit is not in restarted state* 

Run unit is in restarted state* This state occurs when a RERUN request 
was issued* 

Return the old (previous) CRM begin-commit id from the communication 

recovery file* 

Return the new (current) CRM begin-commit id from the communication 

recovery file* 
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The format is: 

COBOL 

ENTER GALLTBN USING tname. 

tname Ol-level data Item containing a 

one- to seven-character trans¬ 
action name. 

FORTRAN 

CALL CALLTRNC tname) 

tname An integer containing a one- to 

seven-character transaction 

name, left-justified with blank 
fill. 


SRERUN Request 

The SRERUN request causes the initial terminal input 
for a rerunnable run unit to be resubmitted to the 
transaction subsystem. The input is retrieved from 
the communication recovery file. The actions that 
occur as result of SRERUN are: 

• The recovery status is set to zero so that 
the recovery task will not be scheduled. 

• The restart status (TSTAT with keyword 
RESTART) is set to one. 

• The SRERUN is done without requesting run 
unit termination. 

The format is: 

COBOL 

ENTER SRERUN USING status[,username]• 

status A computational-1 data item in 

which TAF will return a 
status. The values are: 

0 No errors. 

29 Recovery not installed. 

31 username not in network 
file. 

33 Run unit not rerunnable. 

username 01-level data item containing a 
one- to seven-character user 
name. If this parameter is 
omitted, the rerun applies to 
the user name under which the 
current task is running. 

FORTRAN 

CALL SRERUN(status[,username]) 

status An integer in which TAF will 

return a status. The values 
are: 

0 No errors. 

29 Recovery is not in¬ 
stalled. 


31 username is not in the 
network file. 

33 Run unit is not 
rerunnable. 

username A variable containing a one- to 
seven-character user name, left- 
justified and blank-filled. If 
this parameter is omitted, the 
rerun applies to the originating 
user. 


TINVOKE Request 

The TINVOKE request returns a system identifier to 
be used for all begin-commit sequences in the job or 
task. For TAF, this system Identifier is the trans¬ 
action sequence number. Optionally, for the recovery 
case, the job or task may supply an old system iden¬ 
tifier. This establishes the task or job as a 
continuation of a previous task or job. 

The format is: 

COBOL 

ENTER TINVOKE USING status,new-system-id, 

old-system-ld. 

status A computational-1 item in which 

TAF ^11 return a status. The 
values are: 

0 Request successful• 

32 old-system-id unknown, 

new-system-id A computational-1 item in which 
TAF will return a system identi¬ 
fier to be used for all beg in- 
commit sequences in the job or 
task, 

old-system-id A computetional-1 item in which 
the task or job supplies the 
old system identifier that 
establishes the task or job as 
a continuation of the old one. 

FORTRAN 

CAIL TINVOKE(status,new-system-id,old-system-id) 


status An Integer variable in which 

TAF will return a status. The 
values are: 

0 Request successful. 

32 old-system-id unknown. 

new-system-id An integer in which TAF will 
return a system identifier to 
be used for all begin-commit 
sequences in the task or job. 

old-system-id An integer in which the task or 
job supplies the old system 
identifier that establishes the 
program as a continuation of a 
previous one. 
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FORTRAN 



WSTAT Request 

The WSTAT request records information needed for 
recovery processing on the communication recovery 
file or TAF system tables. WSTAT is used by system 
task CTASK. 

The format is: 

COBOL 

ENTER ’’WSTAT** USING status ,keyword i .value x t • • • * 
keyword^.value^• 

status A computational-1 item whose 

value is set by TAF to indicate 
the status of the request. The 
values are: 

0 No errors« 

29 Keyword specified 

requires TAF auto¬ 
matic recovery. TAF 
automatic recovery 
is not installed. 

30 End of NEXT process¬ 
ing. 

31 USER is not defined 
in the network file. 

400+i keywordj^ is invalid. 

keyword^ An 01-level item containing a 
one- to seven-character keyword 
for which a value is speci¬ 
fied. The keyword must be left- 
justified and blank-filled. Re¬ 
fer to table 2-8 for keyword 
definitions. 

valuej^ A computetlonal-1 item that con¬ 

tains the value for the desired 
keyword. The keyword^ and 
value^ fields must appear in 
pairs. 


CALL WSTAT(status,keywordx,valuex,•••.keyword^, 
value^) 

status An integer whose value is set 

by TAF to give the status of 
the request. The values are: 

0 No errors. 

29 Keyword specified 
requires TAF auto¬ 
matic recovery. TAF 
automatic recovery 
is not installed. 

30 End of NEXT process¬ 
ing. 

31 USER is not defined 
in the network file. 

400+i keywordj^ is invalid. 

keyword^ A variable containing a one- to 
seven-character keyword for 
which a value is specified. 
The keyword must be left- 
justified and blank-filled. 
Refer to table 2-8 for keyword 
definitions. 

valuej^ Integer that contains the value 

of the preceding keyword. The 
keyword^ and value^ must 
appear in pairs. 


The WSTAT keywords (both for COBOL and FORTRAN param¬ 
eters) are given in table 2-8. All keywords neces¬ 
sary for recovery processing for a user name must be 
specified in the WSTAT request. For instance. CTASK 
makes a TSTAT request specifying NEXT, SEQ, STEP, 
TRAN, CRM, and CDCS followed by a WSTAT with SEQ, 
TRAN, CRM, CDCS, OLDID, NEWID, USER, and STEP. Any 
keyword not specified retains the value associated 
with it on the previous WSTAT request. 



60459500 B 


2-41 




Table 2-8. WSTAT Keyword Descriptions 


Keyword 

Value 

Description 

USER 


Set status for user name specified in value. If USER is not specified, 
then the request refers to the originating user name. 

SEQ 


The transaction sequence number specified in value is written for a given 
user name. 

STEP 


Transaction or job step. 


0 

Nbnrecoverable run unit or job input. 


1 

CDCS down. Applies only to recoverable run units. 


2 

Normal transaction cease or job end. Present only for BTRAN or TAP/CRM 
batch concurrency. 


3 

Task or job abort. 


4 

Run unit no longer rerunnable. This occurs when an I/O error is detected 
and the data cannot be recovered for the user. 


5 

Recoverable run unit or job input. 


6 

CRM begln-commlt ids are logged. 


7 

NAM down. Applies only to a recoverable run unit. 


8 

Allow terminal or job input to TAF. 


9 

Terminate TAF because of a recovery error. 

TRAN 


Transaction type. 


1 

Terminal user. 


2 

BTRAN user job. 


3 

1 

TAF/CRM user job. 

CRM 


CRM usage. 


0 

CRM may not be used by transaction. 


1 

CRM may be used by transaction. 

CDCS 


CDCS usage. 


0 

CDCS may not be used by transaction. 


1 

CDCS may be used by transaction. 

OLDID 


Set old (previotjs) CRM begln-commit id on the communcatlon recovery file. 

NEWID 


Set new (current) CRM begln-commit id on the communication recovery file. 
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ACCESS AND USE OF CDCS BY TASKS 


3 


The CYBER Database Control System can be used alone 
or with one other data manager (CRM or TOTAL) In the 
same transaction. If a task is to use CDCS, the 
CDCS reference manuals listed in the preface should 
be consulted for information on how to set up the 
data base (schema, subschema, master directory, and 
files). This data base is associated with CDCS and 
the files will be at the control point of CDCS 
during execution. Tasks can use the CDCS verbs for 
data base access provided that they are compiled 
with the appropriate subschema relating them to a 
CDCS data base* 

In the following, xx represents the two-character 
data base identifier* 

A TAF application (known by the xx identifier in the 
TCF) is linked to a CDCS data base by means of the 
subschemas used in the tasks associated with the 
application (these are the tasks on xxTASKL). All 
tasks in a transaction must use the same subschema 
or a fatal task error (detected by CDCS) will occur. 


A transaction will be considered to be connected to 
CDCS if it has successfully issued a request to CDCS 
and the terminate request to CDCS has not been 
completed. (A CDCS terminate request from other 
than the last task in a chain will be Ignored.) If 
the last task in the chain does not issue a CDCS 
terminate request, one will be issued automatically 
when the last task completes. 

A task will abort if it attempts to use CDCS when 
CDCS is not present in the system or if CDCS aborts 
while a transaction is connected to it. If a task 
aborts while It is connected to CDCS, TAF will issue 
an abnormal termination notice to CDCS for the task 
(unless the abort originated with CDCS). 


Refer to sections 7 and 8 for information regarding 
recoverable transactions and CDCS/transaction aborts. 


The following TAF files are associated with an 
application using CDCS: 


TCF ^ 

^ Required• 

xxJ 


xxTASKL J 

Required unless all tasks are on 
system task library. 

xxJORl ] 

XXJ0R2 
XXJ0R3 J 

Optional. 


Ihe possibility of a deadlock involving CDCS and 
another data manager (TOTAL or CRM) exists. For 
instance, if task X locks some resources under one 
data manager and then tries to lock other resources 
under another data manager that task Y initially 
locked, then the two tasks may be deadlocked if task 
Y tries to lock any of the resources locked by task 
X. It is the responsibility of the installation, 
applications programmers, and the data administrator 
to prevent these situations from occurring. Such 
deadlocks can be prevented by locking resources in a 
specified order only, for example, lock in data 
manager A resources first, then data manager B 
resources, and so forth. 

RESTRICT clauses cause tasks to automatically 
request additional central memory. All of the 
advice and requirements relevant to a task 
requesting that its FL be increased apply when 
RESTRICT clause processing is used (refer to Memory 
Requests, section 2). 
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SYSTEM FILES 


4 


This section is intended for the data administrator 
and can be omitted by the applications programmer. 

This section discusses four topics: the xxJ file, 
journal files, the T/VF configuration file, and the 
communication recovery file. 

An XXJ file is associated t^ith each data base and 
has the following functions. 


CRM DATA MANAGER xxJ FILE 

If data base recovery is to be used, the user speci¬ 
fied on the USER statement must be able to read the 
xxJ file, this can be done by granting read permis¬ 
sion to that user or by making the file public. 

The structure of the xxJ file (when using the CRM 
Data Manager) Is shown as follows. 


• Defines the user^s user name, password, and 
optional user index. 

• Defines optional journal files. 

• Defines optional device residence for the 
task library and some files specific to the 
Individual data managers (refer to the xxJ 
file descriptions that follow). 

Up to three journal files can be specified optionally 
to supplement the system journalizing. A task can 
write to one of the journal files by using the JOURNL 
request. 

TCF, the TAF configuration file, defines the data 
bases associated with a data manager, defines the 
network files and communication recovery files to be 
used, and may contain K display commands. 


xxJ 


USER(username,password, 
familyname)t 
BRF,number 


Required. 


xxJORl,devicetype,filetype. 
xxJ0R2,devicetype,filetype., 
xxJ0R3,devicetype,filetype• 
xxTASKL,PN-packname, 

R^device• 


Optional• 


CRM(xxpfnl,type,mode,users, 
locks,mr1,pkl,hash,rec,fwi, 
packname,device) 
tXN(xxpfxn,naky,packname, 
device) 

AKy(akn,ako,akl) 


I 


*A procedure file (TAFxxxx) is used to initialize TAF. 
Commands may be added to it for recovery or to estab¬ 
lish the operating environment. For example, com¬ 
mands that attach journal files (xxJORn) and data 
base files can be included in this file. Refer to 
the NOS 2 Installation Handbook for more Information 
(refer to the preface for the publication number). 

xxJ FILE 

An indirect access permanent file, xxJ, where xx is 
the data base name, is required for each data base. 
If additional journal files are needed, they are de¬ 
fined in the xxJ file. The xxJ file is saved under 
the transaction subsystem user name. The file is in 
job command format and varies depending on the data 
manager used. 

I NOTE I 

The transaction subsystem user name 
should be under the control of a data 
administrator. The applications pro¬ 
grammer should not have access to 
this name. 


AKY(akn,ako,akl) 
RMKDEF(xxpfni,rkw,rkp,kl,0, 
kf,ks,kg,kc,nl,ie,ch) 


RMKDEF(xxpfni,rkw,rkp,kl,0, 
kf,ks,kg,kc,nl,ie,ch) 

. 

^ One CRM statement 

^ for each file. 

CRM(xxpfn^,type,mode,users, 
locks,mrl,pkl,hash,rec, 
fwi,packname,device) 

IXN(xxp f xn,naky,packname, 
device) 

AKY(akn,ako,akl) 


AKY(akn,ako,akl) 
RMICDEF(xxpfnf|,rkw,rkp,kl, 
0,kf,ks,kg,kc,nl,le,ch) 


RMKDEF(xxpfnn,rkw,rkp,kl, 
0,kf,ks,kg,kc,nl,le,ch) 


tThls is the username, password, and familyname where all data base files and index files described in the 
following CRM and IXN statements are located. 
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The IXN and AKY statements are necessary only for 
multiple Indexed files. The IXN statement describes 
the Index file; the AKY statement describes an alter¬ 
nate key. There Is one AKY statement per alternate 
key. The RMKDEF statement Is necessary If the file 
has multiple Indexes and Is recoverable. The RMKDEF 
statement In the xxJ file must be Identical to the 
RMKDEF statement used in the Initial MIFGEN creation 
of the data base file. There must be one RMKDEF 
statement for each alternate key In the xxJ file* 
More Information on RMKDEF can be found In the CRM 
AAM 2 Reference Manual. 

The parameters for the xxJ file are: 

XX Data base name* 

password Batch password. 

number Number of before Image recovery 

files for this data base. 


The mode parameter controls access 
to the file to ensure that either 
TAF or a batch job can write on or 
modify the file at a given time* 
However, TAF and a batch job can 
read the file simultaneously* Refer 
to the ATTACH command In the NOS 2 
Reference Set, Volume 3, for access 
modes granted for different combin¬ 
ations of multiple access. 


I notFI 

If the TAF procedure file attaches a 
file that Is described on a CRM state¬ 
ment, the mode specified In the TAF 
procedure file overrides the mode par¬ 
ameter In the xxJ file* 


devicetype Device type: 

MS Mass storage. 

MT Seven-track tape. 

NT Nine-track tape. 

filetype File type (refer to figure 4-1): 

B Buffered write. 

R Nonbuffered write. 

packname Pack name of the auxiliary device on 
which the user's task library or data 
base files reside. This parameter 
is optional on the CRM statement. 

device Type of device on which the user's 

task library or data base files 
reside. For example, DI (for an 
844) or D13 (for a multiunit 844 
consisting of three devices). This 
parameter Is optional on the CRM 
statement. 


xxpfnj^ TWO- to seven-character file name* 

XX Is the data base name. pfnj^ Is 
the remaining zero to five charac¬ 
ters In the data base file name. 

type CRM file type: 

AK Actual key. 

DA Direct access. 

IS Indexed sequential. 

mode Attach mode of file xxpfn^^: 

M Modify, append, or read. 

R Read. 

RM Read, with another user 

concurrently attaching the 
file in mode M. 


users Number of transactions allowed to 

open file xxpfn^ concurrently. 
Hhen TAF terminates, the TAF dayfile 
contains a message that gives the 
number of OPEN requests not granted 
because the value of the users par¬ 
ameter was exceeded. Each user uses 
38 words plus the pkl parameter size 
(In words). 

locks Number of records the transaction 

can lock for file xxpfn^. When 
TAF terminates, the TAF dayfile 
contains a message that gives the 
number of locks not granted because 
the value of the locks parameter was 
exceeded. Each lock uses two words 
plus the pkl parameter size (In 
words). 


BUFFERED 

NONBUFFERED 


BYWORD HEADER 


3<AIVORO HEADER 





DATA 



DATA 







EOR 



B^fVORD HEADER 


3-WORD HEADER 





DATA 



DATA 







EOR 


• 

• 

• 

• 

• 

• 

• 



W Write, modify, append, or 
read. 


Figure 4-1. Journal File 
(Buffered and Nonbuffered Structure) 
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mrl Number specifying the maximum record 



length (In characters) 
xxpfui. 

for 

file 

pkl 

Number specifying the 

length 

In 


characters of the primary key 

for 


file xxpfn^J 



hash 

One- to seven-character 

Indirect 


access file that contains the binary 
code of the hashing routine for file 
xxpfnj^. This Indirect access file 
must be stored under the username 
parameter on the USER statement. 
The entry point for the hashing rou¬ 
tine must be this file name (hash). 
If this parameter Is omitted, CRM 
uses the hashing routine supplied 
with CRM. This parameter applies 
only for CRM direct access files. 

rec File recoverability. 

R This file Is recoverable. 

N This file Is not recoverable. 
When rec Is not specified, N 
Is assumed. 

rNorTI 

Adding recoverable files to the data 
base that has a record or key length 
larger than any previously specified 
recoverable file causes recovery file 
validation errors during TAF initial¬ 
ization. Before Image recovery files 
need to be recreated and after Image 
recovery files need to be dumped to 
tape (via DMREC) and recreated. To 
ensure full data base recoverability, 
recoverable files should only be added 
to the data base following a normal 
termination of TAF. 


fwi Forced write Indicator. When the 

forced write Indicator la OFF, the 
modified data file buffers are writ¬ 
ten to disk when space Is needed. 
When the forced write Indicator Is 
ON, all data file buffers that are 
modified In core are written to disk 
Immediately. If fwi Is not speci¬ 
fied, the forced write Indicator is 
set to OFF. 

Y Sets forced write ON for this 
file. 

N Sets forced write OFF for 
this file. 

xxpfxn Permanent file name of the Index 

file; must begin with the two-letter 
application Identifier xx. 


naky Number of alternate keys in the Index 

file. 

akn Alternate key number. Alternate key 

description statements for one data 
base file must be ordered In a con¬ 
tinuous sequence by alternate key 
number. For a detected key, this Is 
the only parameter present In the 
statement. 

ako Alternate key offset. The position 

in the record of the first character 
of the alternate key. This corre¬ 
sponds to the key offset parameter 
used on data manager requests access¬ 
ing the record by this key. The 
first position in the record is char¬ 
acter position number one (not zero). 

akl Length of alternate key in 

characters. 

rkw Relative word In the record in which 

the alternate key begins, counting 
from 0; required. 

rkp Relative beginning character position 

within the relative key word (rkw), 
counting from 0; required. 

kl Number of characters In the key, 1 

to 255; required. 

0 Required to mark position for the 

reserved field. 

kf Key format; required. 

0 or S Symbolic. 

1 or I Integer. 

2 or U Uncollated symbolic. 

3 or P Purge alternate key defi¬ 

nition from the index. 

ks Substructure for each primary key 

list In the index; optional. 

U Unique (default). 

I Indexed sequential; recom¬ 
mended for efficiency In 
processing. 

F First-in, first-out. 

kg Length In characters of the repeating 

group In which the key resides. 

kc Number of occurrences of the repeat¬ 

ing group; zero for T-type records, 
and a number for a repeating group 
embedded within the record. 


tThe user can specify octal numbers and decimal numbers by using a postradix of B or D, respectively. 
Decimal Is the default. 
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Null suppression; a 

null 

value 

is 

all spaces (symbolic 

key) 

or 

all 

zeros (integer key): 




0 Null values 

are 

Indexed 


(default)• 

N Null values are not Indexed, 

ie Include/exclude sparse control char¬ 

acter: 

I Include alternate key value 

If the record contains a 

sparse control character, 

E Exclude alternate key value 

if the record contains a 

sparse control character, 

ch Characters that qualify as sparse 

control characters; up to 36 letters 
and digits can be specified as a 
character string. 


TOTAL DATA MANAGER xxJ FILE 

The following shows the structure of the xxJ file 
when using the TOTAL Data Manager, 

xxJ 

USER( usemaate, password, family name ) t 
UI»n, 

xxJORl,devicetype,filetype, 
xxJ0R2,device type,file type, 

XXJ0R3,devicetype,filetype, 
xxTASKL,PN^packname,R»device, 

ML, 

LG, PN“packname, R“»device , 


aaaa,PNapackname,R^device 


zzzz,PN»packname,R»device 
The parameters for the xxJ file are; 
XX Data base name, 

password Batch password. 


Optional, 


Either the ML 
statement or the 
LG statement must 
be selected. PN 
and R parameters 
are optional, ML 
causes TOTAL to 
not log recovery 
data. LG causes 
TOTAL to log re¬ 
covery data. 


PN and R parame¬ 
ters are optional. 


n User index (obtained from site 

analyst). 

devicetype Device type: 



MS 

Mass storage. 


MT 

Seven-track tape. 


NT 

Nine-track tape. 

filetype 

File type (refer to figure 4-1); 


B 

Buffered write. 


R 

Monbuffered write. 

packname 

Pack name of the auxiliary device on 
which the user's task library 
(xxTASKL) or data sets will reside. 

device 

Type of 

device on which the user's 


file will reside [for example, DI 
(for 844) or DI3 (for a multiunit 
844 consisting of three devices)]. 


aaaa 


zzzz 


Four-character data set names. 


COCS OR NO DATA MANAGER xxJ FILE 

If an application uses CDCS and one of the other data 
managers (CRM or TOTAL)', then the xxJ file should be 
structured as specified for the other data manager. 

If an application accesses only the CDCS Data Manager 
or no data manager, the structure of the xxJ file is 
as follows: 


XXj 

USER(username,password,familyname)t 

xxJORl,devicetype,filetype. 
xxJ0R2,devlcetype,filetype. Optional, 

XXJ0R3,devicetype,filetype, 
xxTASKL,PN« packname,R«device 

The parameters are: 

Parameter Description 

XX Application (data base) name, 

password Batch password, 

devicetype Device type; 

MS Mass storage. 

MT Seven-track tape, 

NT Nine-track tape. 


tTAF locates the data base using the familyname parameter in the procedure file that initializes TAF and the 
username and password parameters in the xxJ file. The username, password, and familyname parameters are 
used for validation. 
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filetype 


packname 


device 


File type (refer to figure 4-1): 


CREATING AN xxJ FILE 


B Buffered vrite. 

R Nonbuffered write. 

Pack name of the auxiliary device on 
which the user's task library 
resides. 


To enter an xxj file, the data administrator can run 
a batch job to create and save the file under the 
transaction subsystem user name. This can also be 
done at a terminal through lAF, (Refer to the NOS 2 
Reference Set, Volume 1, for lAF operating 
instructions.) 


Type of device on which the user's 
task library resides. 
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JOURNAL FILES 


The twD types of journal files are system and data 
base files. 


SYSTEM JOURNAL FILE 

The system journal file (a direct access file named 
JOURO that may be defined under the transaction sub¬ 
system user name or may be set up by the TAFxxxx 
procedure file at initialization) is not associated 
with any particular data base. All transaction data 
(input from terminals), errors, and transaction com¬ 
pletion notification is automatically recorded on 
JOURO. Tl« terminal status table is also journalized 
periodically. Data sent to terminals by tasks is not 
recorded on JOURO. JOURO will be created at initial¬ 
ization if not already present under the transaction 
facility user name. 


jnun Journal File 

0 JOURO (the system journal 

file to which the transac¬ 
tion executive normally 
makes journal entries). 


1 

2 

3 

message Name- of 
taining 
ized. 


Data base 
xxJORl. 


Data base 
XXJ0R2. 


Data base 
XXJ0R3. 

the 01-level 
the message 


journal file 

journal file 

journal file 

data item con- 
to be journal- 


DATA BASE JOURNAL FILES 

The transaction subsystem allows up to three user- 
specified direct access journal files for each data 
base. The allowable names are xxJORl, xxJ0R2, and 
XXJ0R3, where xx is the data base name. At initial¬ 
ization, TAF checks the xxj files associated with 
all active applications to determine which xxJORn 
files are needed. It will then attach any specified 
xxJORn files not already at the control point and 
attempt to define any which it cannot find. The 
transaction subsystem user name must have write 
permission on these files. When a task makes a 
journal request (refer to JOURNL request in this sec¬ 
tion) , the data base for which the originating termi¬ 
nal is validated Is used to determine the journal 
file on which to write. If the task is associated 
with a terminal validated for all data bases, the 
data base specified on the last data base request is 
used to determine the proper journal file. 


JOURNAL FILE ENTRY HEADER 

Each journal file entry (refer to JOURNL request) has 
a header in the format shown in figure 4-2. 


JOURNL REQUEST 

The JOURNL request allows file entries to be made to 
supplement automatic journalizing. 

The format is: 

COBOL 

ENTER JOURNL USING jnum message. 

jnun Computetional-1 item whose value in¬ 
dicates the nunber of the journal 
file to which the entries are to be 
made. The value of this parameter 
must be right-justified and zero- 
filled. 


FORTRAN 

CALL JOURNL(jnun ,message,length) 

jnun Integer whose value indicates the 
nunber of the journal file to which 
the entries are to be made. 

jnun Journal File 

0 JOURO (the system journal 
file to which the transaction 



executive normally 

journal entries). 

makes 

1 

Data base 

xxJORl. 

journal 

file 

2 

Data base 

XXJ0R2. 

journal 

file 

3 

Data base 

journal 

file 


XXJ0R3. 

message Name of the array containing the mes¬ 
sage to be journalized. 

length Integer whose value specifies the 
length of the message in characters. 

COMPASS 

JOURNL address 

address Address of a parameter table in the 
form shown in figure 4-3. 


If a journal file is defined on magnetic tape and an 
end-of-reel is detected, the transaction executive 
unloads the tape and checks for another tape on which 
to write. If the operator has not preassigned a 
unit, the journal file is placed on mass storage. If 
the operator enters the K.ASSIGN command, the trans¬ 
action executive copies the mass storage journal file 
to the tape and places all subsequent entries on the 
tape. If the mass storage file does not fit on the 
tape, the message *UNABL£ TO USE TAPE* is issued. 
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sequence 

Transaction sequence indicator. 

origin 

Origin 

indicator (octal): 


0 

Task origin (JOURNL request). 


1 

Transaction subsystem origin (input). 


2 

Data manager origin. 


3 

Transaction subsystem recovery/statistical data. 


4 

End-of-transaction indicator. 


5 

Incomplete block of terminal input data. 


6 

Terminal input for an interactive task. 


7 

Illegal Intercontrol point transfer. 


10 

On-line LIBTASK update (TT option). 


11 

CDCS detected error (words following header contain error message). 


12 

MSG request with zero function code. Normal FORTRAN messages are logged 
with this function code. 

leng th 

Length of entry (equals header plus data block). 

task name 

Name of 

task if task origin requested. 

hr,min, sec 

Packed 

time (hour, minute, second). 

username 

User name associated with transaction, if task origin, 

_1 



jnum Journal file number, right-just!fled vdLth binary zero fill: 

0 JOURO (right-justified with binary zero fill: makes journal entries), 

I to 3 Data base journal file (xxJORl, xxJOR2, or xxJOR3), 
numwords Length of message in words, 

message Address of message to be journalized. 

Figure 4-3. JOURNL Parameter Table 
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TAF CONFIGURATION FILE 


OFF 


The TAF conflguracion file is a required indirect 
access permanent file saved under the transaction 
facility user name* This file is used during TAF 
initialization and recovery* If it is not local 
when the TAFREC command is reached, TAFREC will 
attempt to get it from TAF^s user index. The TCF 
has the following format: 


USER,UN,PW,FM. 
DMS,datamanager,switch,xx^, 

^^2 > • • • t ^®n* 

NETWORK, ID-i, FM-family, 
(JNausername* 


/ At least one of 
I each required* 


RECOVER,ID»i,MS«maximumsize, 
NM»number. 


Required or not 
allowed (refer to 
statement de¬ 
scription* 


TABCON,n 


Required for 
batch concur¬ 
rency* Refer to 
the TAF/CRM Data 
Manager Reference 
Manual* 


DISPLAY,status. 

K* command |^«value \. 


Optional* 


K* commandQaivalueQ 


DMS STATEMENT 

DMS statements on the TCF are used to specify the 
data managers to be loaded by TAF and the applica¬ 
tions (data bases) to be associated with each data 
manager* 

The format is: 

DMS,da tamanage r,switch,xxj,xx 2 ,.* *,xxq. 

data Name of the data manager* Must 

manager be CRM, TOTAL, or OTHER. The 

same data manager can be speci¬ 
fied on any number of DMS state¬ 
ments. Use the datamanager 

value OTHER for specifying an 
application that Is either not 
associated with a data manager 
or is associated only with the 
CDCS Data Manager. 

switch Data manager status* Must be 

ON or OFF* 

ON The specified data 

manager (TOTAL or CRM) 
will be loaded* The 
data bases specified 
on the same statement 
are to be made avail¬ 
able for TAF process¬ 
ing. These data bases 
are referred to as 
active. 


Data bases specified 
on the same statement 
are not made available 
for TAF processing* 

xxj^ Data base identifier* Must not 

be duplicated on the same or 
any other active DMS statement. 
For the CRM Data Manager, it is 
the two-letter data base name. 
For the TOTAL Data Manager, this 
parameter has the format: 

xxyyyy 

which is the data base name (the 
DBMOOt file name) specified in 
the DATA-BASE-NAMEt statement 
of Che DBDLt statements, xx is 
the unique TAF data base name 
and yyyy is any combination of 
four alphanumeric characters* 

A separate DMS statement for CDCS (OTHER) is not 
necessary if CDCS is to be used in conjunction with 
another data manager. 

The TCF file must contain at least one DMS statement 
and each DMS statement with status set to ON must 
have at least one data base identifier or TAF will 
abort* 

The maximum number of data bases that may be associ¬ 
ated with one data manager is specified by the in¬ 
stallation parameter MAXDB* This value is 25 unless 
it is altered by the user^s site. 

The maximum length of each DMS statement is 160 6-blt 
display code characters* 


DISPLAY STATEMENT 

The DISPLAY statement on the TCF controls whether or 
not the TAF K display will appear at the console dur¬ 
ing initialization and recovery* However, an error 
in a K display command causes TAFREC to issue an 
error message and bring up the K display for correc¬ 
tions regardless of the DISPLAY statement. The 
format is: 

DISPLAY,status. 

status A variable having one of the 

following values. 

ON K display will appear 
at the console during 
initialization and 

recovery to enable the 
operator to make 
changes at those times. 


OFF K display will not 
appear at the console 
during initialization 
and recovery. 


tRefer to the TOTAL - CDC 2 Reference Manual for a detailed description. 
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NETWORK STATEMENT 

The NETWORK statements on the TCF declare the 
network files (NCTFl) TAF uses to determine the 
users allowed to access TAF. There must be at least 
one and a maximum of eight NETWORK statements. The 
format is: 


NETWORK,ID»i,FM»famllyname,UN“username• 


i An integer specifying a unique 

network file identifier. The 
range is zero to seven. This 
identifier is used in 
constructing the name of the 
network file (NCTFi). 

famllyname The family name under which the 
network file exists. If the 
famllyname parameter is not 
specified, the default family 
name is used. 


username The user name under which the 
network file exists. If the 
username parameter is not 
specified, the TAF user name is 
used. 


RECOVER STATEMENT 

The RECOVER statement on the TCF declares the set of 
files TAF is to use when in recovery mode. This 
directive is required if TAF is assembled with 
recovery, but it is not allowed if TAF is assembled 
without recovery. 

The format is: 

RECOVER,ID*i,MS^maximumsize,NM*number. 

i An integer specifying a unique 

recovery file id. The range is 
zero to seven. This id is the 
Id used in constructing the 
name of the communication 
recovery file (ZZCRFl). Only 
one id may be specified per 
RECOVER statement. The id must 
match an id specified in a 
NETWORK statement. 

maxlmumsize An integer specifying the maxi¬ 
mum size of the message, in 
words, that TAF will record on 
the communication recovery file. 
The default is 57. Maximum is 
installation parameter MAXWS. 
This is the maximum message 
size for the RPUT and SECURE 
requests. 

number An integer specifying the maxi¬ 

mum number of user messages that 
can be recorded on the communi¬ 
cation recovery file via the 
RPUT request. The default is 
zero, the maximum is 10. 

Each RECOVER statement specifies a recovery id. This 
id determines the communication recovery file that 


TAF will use. The name of the corresponding CRF is 
ZZCRFi. The CRF resides under the same family and 
user name as the corresponding network file. 



K. STATEMENT 



Any K display commands that can be issued under the 
initial K display can appear in the TCF. Values 
specified in the TCF become the default values in 
place of the installation defaults (refer to the K I 
display utilities in the NOS 2 Analysis Handbook for | 
the installation default values). If the operator 
changes any of these values during initialization, 
those changes remain in effect if TAF is restarted 
in recovery mode. 

If K display commands are used in the TCF, they must 
appear consecutively. 


USER STATEMENT 


The USER statement on the TCF specifies the user 
name under which TAF is to run. This user name 
should be defined through MOOVAL to have the same 
user index as defined by the installation parameter 
TRUI. Only one USER statement is allowed in the 
TCF. The format is as follows: 



USER,UN,PW,FM. 

or 

ACCOUNT, UN, PW,FM. 

Parameter Description 

UN The user name under which TAF is to 

run. 

PW The batch password for the user name. 

FH The family under which TAF is to run. 

The USER statement should be the first statement in 
the TCF. 



COMMUNICATION RECOVERY FILE 

A communication recovery file is a file TAF uses to 
maintain recovery information about recoverable 
transactions. New CRFs are created and existing 
CRFs are reinitialized at initialization time by 
using the K.INT command (refer to section 8). There 
can be up to eight of these files (named CRFO, 
CRFl,...,CRF7). 

Each one corresponds to a network file having the 
same Identifier (NCTFO, NCTFl,...,NCTF7). For every 
user description statement in a network file, there 
is a user entry in the corresponding CRF. These 
entries are added and deleted as follows: 

• New user entries are added to a CRF by 
adding a user description statement to the 
corresponding network file. 

• User entries are removed from a CRF by 
removing the user description statement from 
the corresponding network file. 


4-8 


60459500 C 





TRANSACTION FACILITY (TAF) K DISPLAYS 

The following commands control operation of the TAF Subsystem, Initiate the TAF Subsystem 
by using the TAFffff command before issuing these commands • 


INITIATING TAF K DISPLAY 

When the transaction executive is brought to a control point, the message 

REQUEST *K* DISPLAY appears at the control point if a DISPLAY,ON command is specified 

in the TAF configuration file. Respond with the entry: 

K,TAF. 

Any of the following initialization commands can then be entered. If no values are to be 
changed, enter the command: 

K.END. 

Values are decimal unless otherwise indicated. 

Command Description 

K.BFL=n. Changes the starting and minimum field length allocated by TAF to 

CRM (20000g ^ n ^ lOOOOOg)* Default is 700008* 

K.CMB=n. Changes the maximum number of communication blocks allowed to the 

TAF Subsystem (7 ^ n ^ 40). Default is 40. 

K.ECS=n. Sets the extended memory field length to be used by the transaction 

executive; n is octal thousands of words. Default is 0. 

K.EFL=n. Changes the maximum additional central memory field length made 

available to CRM for buffers and capsules (0 < n < lOOOOOg). 

Default is 0. — — 

K*END. Ends input of the transaction executive initialization parameters. 

Initialization is completed when the TAF K display appears • 
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Command 


Description 


K.ERO=CRF,op# 


K.GO* 

K • INT=typ, f Held. 


Specifies whether to override certain I/O and logic errors when 
processing the communication recovery files (CRF). 


op Description 

NO Aborts if I/O or logic errors are encountered while 

processing the communication recovery files. This is 
the default setting. 

YES I/O or logic errors encountered on a run unit header 
record result in the loss of that run unit with no 
indication to the terminal user. The loss is noted on 
the recovery report. 

I/O or logic errors encountered on a message record 
within a run unit result in a loss of that run unit. A 
status field is set in the run unit header, allowing TAF 
to inform the terminal user of the run unit loss. 

I/O or logic errors encountered on the CRF header record 
result in an unconditional abort of the TAF Subsystem. 

Ends input of the transaction executive initialization parameters. 
Initialization is complete when the TAF K display appears. 

Specifies which communication recovery files (CRF) are to be 
initialized. This is the only way to initialize a CRF. Files 
specified on a RECOVER command in the TAF configuration file and 
specified in this command are initialized. Files specified on a 
RECOVER command but not specified in this command are used for 
recovery» 

This command also specifies whether CYBER record manager (CRM) data 
base recovery files are initialized or recovered. For CRM recovery 
files, this command is valid regardless of TAF assembly parameters. 


tiP 

CRF 

CRM 


Description 

Communication recovery files. This parameter is valid 
only if the installation parameter IPTAR equals 1. 

CYBER Record Manager after-image and before-image 
recovery files. 
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Command 


Descriotion 


K.MFL=n. 

K.REC=a. 

K.SCP=n. 

K.STOP. 

K.TFL=n, 

K.TLF=filename• 


fileid 


Description 


n A digit from 1 to 7 that defines a CRF to be 

initialized. The digit corresponds to the ID parameter 
on the RECOVER command in the TAF configuration file. 
This parameter is not valid for CRM recovery files, 

ALL If typ is CRF, all communication recovery files defined 
by RECOVER commands in the TAF configuration file are 
initialized. If typ is CRM, all CRM recovery files are 
initialized. 


NOTE 


This parameter must be used with caution 
when typ is CRM since the CRM update history 
currently on the after-image recovery files 
is lost. 


NONE If typ is CRF, communication recovery files are 

initialized; all communication recovery files specified 
in RECOVER commands in the TAF configuration file are 
recovered. If typ is CRM, all CRM data bases are 
recovered based on information in the existing recovery 
files. No CRM recovery files are initialized. This 
fileid is the default for both typ=CRF and typ=CRM. 

Sets the maximum field length to be used by the transaction 
executive (40000 ^n <_ 376600). Default is 376600. 

Specifies whether to set the recovery bit in the user area of each 
terminal status table entry (YES or NO). If YES, the user recovery 
bit is set. If NO, the value of the user recovery bit is not 
changed from what it was before the command was issued. Default is 
NO. 

Changes the number of subcontrol points (2 £ n _< 31), Default is 31. 

Aborts the TAF Subsystem initialization unconditionally. 

Changes the value used as the upper bound for TARGET. This is the 
amount of memory CRM uses for data and index blocks 
(lOOOOg ^ n _< IOOOOO 3 ). Default is 3 OOOO 3 , more 

information, refer to the CYBER Record Manager Advanced Access 
Methods Version 2 Reference Manual. 

Changes the name of the system task library file (any valid file 
name). Default is TASKLIB. 
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RESTARTING TAP K DISPLAY 

On a level 3 recovery deadstart, or if the TAF Subsystem aborts, the TAF procedure file 
automatically restarts TAF by transferring control to the TAF automatic recovery program. 
The TAF automatic recovery program recovers the central memory pointers and variables 
defined during TAF initiation. 

If a DISPLAY,ON command is in the TAF configuration file, the automatic recovery program 
brings up the K display on the left console screen. This display is identical to the 
initial K display, except that values specified in the TAF initiation replace any default 
values that were in the initial display. 


TAF K DISPLAY 

When the TAF Subsystem is executing, the TAF K display indicates the: 

• Latest transaction sequence number. 

• Number of words of unused memory. 

• Maximum field length. 

• Global task dump limit. 

• Subsystem default values for memory dump parameters. 

The TAF K display appears on the system console as shown in figure 8-31. 

-* __ 

The subsystem default values are used to control memory dumps when parameters are not 
included in the CMDUMP or DSDUMP command. Any of these default values can be changed by 
specifying the corresponding parameter in the K.DSDUMP command. 
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The default parameter values for the CMDUMP and DSDUMP commands are given on the TAP K 
display shown in figure 8-31 • 


Parameter 

DB 

EP 

FW 

LW 

OQ 


QD 


Description 

This parameter is not used* It is retained for compatibility with 
previous releases of NOS. 

Exchange package: 

0 Do not dump the exchange package. 

1 Dump the exchange package. 

First word address of the task memory to be dumped. 

Last word address of the task memory to be dumped. 

Output queue: 

BC Local batch. 

RB Remote batch. 

PF Permanent file. 

Queue destination: 

User name (if OQ=BC). 

Equipment identifier (if OQ®RB). 

Permanent file name (if OQ=PF), 


TAF K-DISPLAY COMMANDS 

When the transaction executive is at its control point, the following commands can be 
entered from the system console or submitted from tasks using the KPOINT request. Any task 
can issue the K.DUMP command. Only tasks that reside on the system task library can issue 
the other K-display commands. (Refer to the TAF Reference Manual for additional information 
on the KPOINT request and the system task library.) 


Command 


Description 


K.ASSIGN,est. 
or 

K.ASSIGN,est,db,n* 


Assigns a magnetic tape unit to be used for a journal file, est is 
the EST ordinal of the tape unit. The first form of the command 
makes unit est available for the transaction executive to assign to 
the next tape journal file that encounters end of reel. Two tape 
units may be preassigned. If a tape has not been preassigned in 
this manner, an end-of-reel on a journal file causes subsequent 
entries for that file to be placed on disk. 
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Connnand 


K.DEBUG. 


K.DROP,n. 

K.DSDUMP,FW=addr, 
LW=addr,EP=pkg, 
OQ=out:q ,QD=qdest, 
DB=db. 


K.DUMP,fwa,lwa. 


Description 

The second form of the command forces journal file n (n=l, or 3) 
for data base db, defined as a tape file, from disk to tape. The 
transaction executive copies the data from the disk journal file to 
tape est and places all subsequent entries for that file on the 
tape. This command is necessary after the transaction executive 
initialization to assign tape units to the tape journal files or 
after an end-of-reel on a tape journal file when no tape had been 
preassigned to the transaction executive. All data residing on the 
disk for t-he tape journal file must fit on the tape assigned by this 
command or the transaction executive will unload the tape and issue 
the message *UNABLE TO USE TAPE*. 

Turns on the application interface program (AIP) debug optioni which 
logs all messages on trace file ZZZZZDN. Use this command only when 
TAF is installed with the DEBUG option. 

Drops an executing task at subcontrol point n. 

Allows you to modify the standard system default parameters 
controlling memory dumps. The command does'not directly cause a 
dump. Rather, it sets default values to be used when a subsequent 
CMDUMP request is received or when abort conditions occur. Refer to 
TAF K Display, earlier in this sect±on, for explanations-of the 
parameters• 

Dumps all or part of the field length of the Transaction Facility 
from the first word address (fwa) to the last word address (Iwa) of 
the area to be dumped. The default value for fwa is 0 and for Iwa 
377777g, The default base is octal. If no parameters are 
specified, the entire field length is dumped. The output is routed 
to a printer that has an ID of 0. 

Unlike other K-display commands, the K.DUMP command can be issued 
from any task. Other K—display commands can be issued by tasks only 
if they are on the system task library (refer to the TAF Reference 
Manual). 

Since secure information may be contained in a dump of the 
Transaction Facility, the following safeguards have been set up to 
protect dumped information; however, the installation must take the 
ultimate responsibility for the protection of dumped information. 

• The global task dump limit (GTDL) can be set by the 
K.DUMPLIM command to limit the number of times the K.DUMP 
command can be issued from tasks. The initial value of the 
GTDL is 0 (zero), so the K.DUMP command is disabled from use 
by a task by default. 

• For all dumps of the Transaction Facility, whether you 
initiated it or a task did, a one-page header precedes the 
dump. This header page indicates the output is secure and 
should be given only to the TAF central site systems analyst. 

• When the Transaction Facility is dumped, the message TAF 
FIELD LENGTH DUMP RELEASED is issued to the system dayfile, 
the Transaction Facility dayfile, and line one of the 
control point. 
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Command 


Description 


K.DUMPLIM,n. 


K,IDLE. 


K.JEND,db,n. 


K.MAXFL,n. 


K.MESSAGE,TN=b. 
message* 

K.NODEBUG. 


Sets GTDL to value n (0 £ n £ 9999999). If n is not specified, the 
GTDL is set to 0. 

The GTDL is the number of times the K.DUMP command can be issued 
from tasks. This value is displayed on the TAF K display shown in 
figure 8-31. The initial value of the GTDL is 0. When the GTDL is 
0, no dumps of the Transaction Facility can occur from tasks. Thus, 
the K.DUMP command is disabled from tasks by default. 

To enable the K.DUMP command for tasks, issue the K.DUMPLIM command 
to set the GTDL to a value greater than zero* Each time a task 
issues a K.DUMP command, the GTDL is decreased by one until it 
equals zero. When the first K.DUMP command is issued from a task 
with the GTDL equal to zero, the message 

GLOBAL TASK DUMP LIMIT EXHAUSTED 

is issued to the Transaction Facility dayfile, the system dayfile, 
and line one of the control point. Also, the message 

DUMPS LOST 

is displayed on the K display in place^of the value of the GTDL. 

This message remains until the value of GTDL is set to a value ^ 
greater than or equal to zero. The K.DUMPLIM command should be used 
with care in system tasks, since this might allow unauthorized users 
to alter the GTDL. 

Idles down the transaction control point. Once idle down has been 
initiated, no new transactions will be permitted but currently 
executing transactions will be allowed to finish. 

Forces end-of-reel processing (writes an EOI and rewinds the file) 
on tape Journal file n of data base db. If n is not a tape journal 
file, the command is ignored. 

Alters the transaction executive maximum field length. The 
transaction executive does not attempt to obtain more than n words 
of storage. This command is rejected if the value for n is more 
than 3766 OO 3 or less than the field length currently required for 
TAF. 

Directs the transaction executive to send message to a terminal 
specified by terminal name b. 

Turns off the application interface program (AIP) debug option, 
which logs all messages on trace file ZZZZZDN. Use this command 
only when TAF is installed with the DEBUG option. 
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Command 

K*OFFTASK,a,db. 


K.ONTASK.a,db. 


K•ROLLTIM,nnnnnn• 


K.SWITCH. 


K.TBCpN,nn. 


K.TST,TN=a,DB=db, 
U=nnnn, UL=Tiiinmra, 
NN=b. 


Description 


Disables the use of task a, where a is the task name in the data 
base db task library directory (dbTASKL). The data base name db is 
not specified for tasks in the system task library. 

Reverses the effect of a previous OFFTASK command for the specified 
task a in the data base db task library directory (dbTASKL). The 
data base name db is not specified for tasks in the system task 
library (TASKLIB). 

Changes the amount of time that TAF will retain its field length 
between communication input messages; nnnnnn is specified in units 
of milliseconds. Refer to the installation parameter ITRTI, in the 
NOS 2 Installation Handbook. 

Causes the console K display to change to a display listing all 
allowable console commands. When K.SWITCH is entered a second time, 
the normal display returns. This command activates task KDIS and 
forces TAF to remain rolled in. 

Changes the number of TAF/CRM batch concurrency users; nn is less 
than or equal to the value specified on the TBCON command in TAF^s 
configuration file (TCF). 

Changes entries in the terminal status table for terminal a. The 
following entries can be changed: data base name db, user area 
upper 12 bits (nnnn), user area lower 12 bits (mmmm) , and new 
terminal name b. The changes do not affect the network and 
simulation files. Do not use this command if the terminal is logged 
in. 
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TAF/CRM STATUS K DISPLAYS AND COMMANDS 


You can use the K display to monitor the status of CRM, CRM data bases, or CRM data base 
permanent files while TAF/CRM is running if CRMTASK is present on the system task library • 
To get the CRM status K display enter: 

K.DIS, CRMTASK. 


After the K display is assigned to the task, the display in figure 8-32 is brought to the 
left screen. 



The following commands are available under CRMTASK. 

Command Description 

K.CRMSTAT. Selects the CRM status K display (see figure 8-33). This display 

shows the status of all CRM data bases. 

K.CRMSTAT,db. Selects the CRM data base status K display (see figure 8-34). This 

display shows the status of the specific CRM data base with 
identifier db. It also shows the file name and status of the 
before-image files. 

K.CRMSTAT,dbfile. Selects the CRM file status K display (see figure 8-35). This 

display shows the status of the specific permanent file in a CRM 
data base with file name dbfile. 

K.DBDOWN,db. Makes a specific CRM data base with identifier db unavailable for 

processing. When this command executes, the CRMTASK command 
directory appears on the K display. 
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CoTEmand 

K.DBDOWN,dbfile. 


K,DBUP,db. 


K.DBUP,dbfile. 


Description 

Makes a specific permanent file in a CRM data base with file name 
dbfile unavailable for processing* When this command executes, the 
CRMTASK command directory appears on the K display* 

Makes a specific CRM data base with identifier db available for 
processing* When this command executes, the CRMTASK command 
directory appears on the K display. 

Makes av,.specific permanent file in a CRM data base with file name 
dbfile available for processing. When this command executes, the 
CRMTASK command directory appears on the K display. 
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** CRH DATA BASE STATUS ** 


DATA BASE » db DATA BASE STATUS = UP 

AFTER IHAGE FILE = arfname PRU-S REMAINING = nnn 

BEFORE IHAGE FILES AND STATUSES 

ZZAAB01-U ZZAAB02-U ZZAAB03-U ZZAAB04-D ZZAAB05-U 
ZZAAB06-U ZZAAB07-D 


FILE 

STATUS 

FILE 

STATUS 

FILE 

STATUS 

AAPFN01 

UP ' 

AAPFN02 

DOWN 

AAPFN03 

DOWN 

AAPFN04 

AAPFN07 

IDLE 

UP 

AAPFNOS 

UP 

AAPFN06 

UP 


VALID COMMANDS ARE - 

CRMSTAT. CRMSTAT,DB. CRMSTAT,DBPFN. END. +. 
DBUP^DB. DBUP,DBPFN. DBDOWN^DB. DBDOWN^DBPFN. 


Figure 8-34. CRM Data Base Status K Display 


** CRH FILE STATUS ** 

FILE NAME = AAPFN01 
FILE STATUS = UP 
RECOVERABLE = YES 

PACK NAME = PACKNAM 
DEVICE TYPE = DJ3 
ATTACH MODE = RM 

SIZE OF PRIMARY KEY = 80 
NUMBER OF ALTERNATE KEYS = 3 

ACTIVE USERS = 4 
ACTIVE LOCKS = 8 


VALID COMMANDS ARE - 

CRMSTAT. CRMSTAT,DB. CRMSTAT,DBPFN. END. 
DBUP,DB. DBUP,DBPFN. DBDOWN,DB. DBDOWN^DBPFN. 


Figure 8-35. CRM File Status K Display 



For the CRM status and CRM data base status displays, if all the information does not fit on 
one screen, you can bring up additional pages by entering the following command. 


K.+ . 


To return to the first page of the display, enter the following command. 


K.-. 

At any time you can return to the initial CRMTASK K display (figure 8-32) by entering the 
following command. 

K.MENU. 

To end CRM status K-display processing, enter the following command. 

K.END. 
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Each user encry in a CRF contains space for initial 
transaction input, RPUT messages, and a SECURE mes¬ 
sage* Two important CRF attributes are the number 
of messages, number, that a recoverable run unit may 
record on the file and the maximum siae of these 
messages, maxlmumsize* the values for these param¬ 
eters are given in the RECOVER statement in the TCF. 


To reduce the number of user messages and/or the 
message size, the CRF must be reinitialized using 
the K.INT command (refer to section 8). 

Under certain circumstances a CRF is reformatted 
during recovery. Refer to section 8 for details. 
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BATCH/TRANSACTION SUBSYSTEM INTERACTION 


5 


The transaction subsystem interfaces with the batch 
subsystem In three vays« First, batch jobs can 
initiate tasks by using the BTRAN request# Second, 
tasks can route jobs to the batch input queue by 
using the SUBMT request# Third, batch jobs can 
access TAF/CRM data files using the TAF/CRM batch 
concurrency feature# 

The BTRAN and SUBMT requests are described in this 
section# The TAF/CRM batch concurrency feature is 
described in the TAF/CRM Data Manager 1 Reference 
Manual• 


BTRAN REQUEST 

The BTRAN request enables a batch job to start a 

transaction. The transaction Is passed to the 

transaction executive through the system control 
point mechanism; therefore, the user must be 

validated for system control point communication 
(AW»CUCP)# Ihe user passes a transaction to the 
transaction executive via the header word shown in 
figure 5-1. 

Multiple logins under one user name are not 
permitted in TAF# Thus, the user name for a Job 

issuing a BTRAN request must not be in use within 
TAF by a transaction terminal or another batch job# 
Any SEND (or DISPLAY) requests in a BTRAN-initiated 
transaction must explicitly specify a user name 
different from the one under which the batch job is 
being run# Unlike a terminal-initiated transaction, 
BTRAN-initiated transactions are not required to 
issue any SEND request# A transaction can use the 
TSTAT request with the TRAN keyword to determine 
whether it was initiated with BTRAN# 

The format is: 

COBOL 


ENTER BTRAN USING transaction status# 

transaction Name of the 01-Ievel item 

containing the header word 
for the transaction to be 
sulmiitted # 

status Name of the data that con¬ 

tains the returned status; 
the status is returned as a 
computetional-1 value# 

Decimal status values are shown in table 5-1# 


FORTRAN 

The user calls the BTRAN request in two ways. 

The first method is a FORTRAN function# 

i»BTRAN(transaction) 

i Integer variable that con¬ 

tains the request status 
after BTRAN is called# The 
user must declare BTRAN as 
an integer. 

transaction Name of the array containing 

the header word for the 
transaction to be submitted# 

The second method is a subroutine call# 


CALL BTRAN(transaction,status) 

transaction Name of the array containing 
the header word for the 
transaction to be submitted# 

status Address of the variable that 

contains the returned status; 
the status is returned as an 
integer value# 

Decimal status values are shown in table 5-1# 

COMPASS 

BTRAN transaction 

transaction Address of the header word 
for the transaction to be 
submitted# 

The status of the request is returned in regi¬ 
ster X6# 

Decimal status values are shown in table 5-1# 

Figure 5-2 demonstrates the use of BTRAN. 

In the example shown in figure 5-2, LP3 is the name 
of the transaction to be processed by TAF# 50 is an 
item of data to be used by. this transaction# 
STATUS»n goes to the OUTPUT file associated with the 
batch job# Output from the transaction cannot be 
sent to the user name under which the job is being 
run# Output to other user names (terminals) is 
permitted but not required# 
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reserved 

length 

transaction data 


length Length of the transaction in words; Includes the header word and the trans¬ 

action data* 

transaction data Transaction name (or transaction name and input data) to be processed by TAF* 

Figure 5-1. BTRAN Header Word 


BTRANEX. 

USER^XY21234,XY21. 

CHARGE,* 

C0B0L5. 

LIBLOAD(TRANLIB,BTRAN) 

LGO. 

- -EOR- - 

IDENTIFICATION DIVISION. 

PROGRAM-ID. BTRANEX. 

ENVIRONMENT DIVISION. 

CONFIGURATION SECTION. 

SOURCE-COMPUT ER. CYBER. 

OBJECT-COMPUTER. CYBER. 

DATA DIVISION. 

WORKING-STORAGE SECTION. 

01 BATCH-TRANSACTION. 

02 RESERVED-AREA 
02 DATA-LENGTH 
02 TRANSACTION-DATA 
01 BTRAN-STATUS 
PROCEDURE DIVISION. 

START-RUN. 

ENTER BTRAN USING BATCH-TRANSACTION, BTRAN-STATUS. 
DISPLAY "STATUS*** BTRAN-STATUS. 

STOP RUN. 


PIC X<7). 

VALUE 2 COKP-4 PIC 9999. 
VALUE IS "LP3,50" PIC X(6). 
VALUE IS 0 COMP-1 PIC 9999. 


Figure 5-2. BTRAN Request 


Table 5-1• BTRAN Status Values 


Value 

Description 

Value 

Description 

1 

Transaction submission is complete. 

15 

The user name associated with the batch 
job issuing the BTRAN request is not 

3 

The transaction executive is not 


validated in network file (job is 


present. 


aborted). 

5 

The transaction executive is busy 
(should not occur; Inform site 

17 

The user name associated with the batch 


analyst). 


job issuing the BTRAN request is cur¬ 
rently in use within TAF. 

■ 

The submit block is too long; the maxi¬ 
mum length is 62 words. 

19 

A conflict in access types was detec¬ 
ted. the previous transaction run 


The transaction subsystem is not de¬ 


under the specified user name was 


fined as a system control point (should 


recoverable and not associated with a 


not occur; Inform site analyst). 


BTRAN-initiated transaction. 


Access to TAP is denied because TAP is 

21 

The transaction data is not within the 

■■ 

idling down. 


field length of the batch job. 
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COMPASS 



SUBMT REQUEST 

The SUBMT request allows a task to route a job to the 
local batch input queue* The address parameter In 
the call points to the area in the task field length 
that contains the Job to be routed in control word 
format. This format is described in conjunction with 
the READCW macro in the NOS 2 Reference Set, Voliane 
4 (refer to the preface for the publication nimber). 
Using this format, the job may consist of multiple 
records. 

The format is: 

COBOL 

ENTER SUBMT USING address. 

address Name of the 01-level item 

containing the job data to be 
routed. This data is in the 
format shown in figure 5-3. 

FORTRAN 

CALL SUEMT(addres8) 

address Name of an array containing the 

job data to be routed. This 
data is in the format shown in 
figure 5-3. 


SUBMT address 

address Address of the first word of the 
job data to be routed in control 
word format as shown in figure 
5-3. 


The first word at address must be a control word in 
the format shown previously. The length field must 
specify the number of 12-bit bytes occupied by the 
data in the PRU (maximum of 320 bytes, equivalent to 
640 characters). The level number in the trailing 
control word specifies whether the PRU is an end-of- 
record or end-of-flle. If a logical record extends 
over more than one PRU, the level nxmber for the 
first PRU of the record must be nonzero and other 
than 173. 

A leading and a trailing control word must be 
present for each PRU of data. 

Typically, the data would consist of commands which | 
would comprise one record. Additional data to be 
processed by the batch job could also be present and 
typically constitute subsequent records. 



memorv words 



Length in 12-bit (two-character) bytes of job data following this control word 
(must be five times the number of the central memory words). 

Logical record level number: 

0 or omitted This PRU is an end-of-record. 

17o This PRU is an end-of-file. 


Figure 5-3. SUBMT Parameter Table 
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Figure 5-4 shows a task using the SUBMT request. 

In the example shown in figure 3-4» the first word 
of JOB (00390 to 00410) sets bit 42 in the header 
word and gives the length (75) in 12-bit bytes of 
the card deck Images to follow. This is five times 
the ntmber of 10-character (60-bit) words in the job 
being submitted, In this case, statements 00420 to 
00590. 

Each job command must be from 1 to 80 characters 
long. All commands to be submitted must be padded 
to a multiple of 10 characters and the last 2 
characters must be binary zero (character In the 
63 / 64-character set). Thus, if a statement ends in 
character position 9,10; 19,20; and so on, a zero 

word must be appended. Statements 00460 to 00530 
give examples of this. 


At job termination, the implicit output files of the 
SUBMT job are not queued by the system. This is 
because lAF routes the submitted job using the 
disposition code DC»N0. To obtain output from the 
job, do either of the following: 


• Include ROUTE commands to place the desired 
files in the appropriate queues. 


• Include the command SETJ0B,DC°DF in the 
submitted job. This directs that implicit 
output is to be queued at the end of the job. 


The example in figure 5-4 uses the first method by 
including a ROUTE command at line 00580. 


00100 IDENTIFICATION DIVISION. 
00110 PROGRAM-ID. SUBTEX1. 
00120 ENVIRONMENT DIVISION. 
00130 DATA DIVISION. 

00140 COMMON-STORAGE SECTION. 


Standard COBOL Communication Block (refer to section 2) 


00370 WORKING-STORAGE SECTION. 
00380 01 JOB. 


00390 

03 

FILLER 

VALUE 

IS 

1 

COMP-4 

PIC 

9(5) 

00400 

03 

FILLER 

VALUE 

IS 

0 

COMP-4 

PIC 

9(5) 

00410 

03 

JOB-LENGTH 

VALUE 

IS 

75 

COMP-4 

PIC 

9(6) 


* 


* THE FOLLOWING IS THE JOB TO BE SUBMITTED 

* 


00420 

03 

JCe-CARD. 






00430 


05 

JOB-ID 

VALUE 

IS 

"JOB." 

PIC 

X(4). 

00440 


05 

FILLER 

VALUE 

IS 

ALL 

PIC 

X(6). 

00450 

03 

JOB-USER. 






00460 


05 

USER-CARD 

VALUE 

IS 

"U SE R ^0WG2603^ ABC123." 

PIC 

X(20). 

00470 


05 

FILLER 

VALUE 

IS 

ALL 

PIC 

XdO). 

00480 

03 

JOB’ 

-CHARGE. 






00490 


05 

CHG-CARD 

VALUE 

IS 

"CHARGE^5927^693X451 

PIC 

X(20). 

00500 


05 

FILLER 

VALUE 

IS 

ALL 

PIC 

XdO). 

00510 

03 

JOB-DATA. 






00520 


05 

COMMENT 

VALUE 

IS 

SUBMIT BATCH JOB." 

PIC 

X(19). 

00530 


05 

FILLER 

VALUE 

IS 

ALL 

PIC 

X(11). 

00540 


05 

CTR-STATUS-1 

VALUE 

IS 

"REWIND^INPUT." 

PIC 

X(13). 

00550 


05 

FILLER 

VALUE 

IS 

ALL 

PIC 

X(7). 

00560 


05 

CTR-STATUS-2 

VALUE 

IS 

"COPYSBF." 

PIC 

X(8). 

00570 


05 

FILLER 

VALUE 

IS 

ALL 

PIC 

X(2). 

00580 


05 

CTR-STATUS-3 

VALUE 

IS 

"R0UTE,0UTPUT." 

PIC 

X(13). 

00590 


05 

FILLER 

VALUE 

IS 

ALL 

PIC 

X(7). 


* 


* SUBMITTED JOB ENDS HERE 

* 

00600 03 INPUT-LEVEL VALUE IS 15 COMP-4 PIC 99. 

00610 03 FILLER VALUE IS ALL **:'* PIC X(8). 

00620 PROCEDURE DIVISION. 

00630 START-UP. 

00640 ENTER SUBMT USING JOB. 

00650 DISPLAY "JOB SUBMITTED.". 

00660 STOP RUN. 


I 


3 



Figure 5-4. SUBMT Bequest 
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MEMORY DUMPS 


6 


A task can perform two types of memory dumps. The 
first type is a task dump, which is a dump of the 
task field length, exchange package, and associated 
data buffers. A task dump aids the applications 
progransner in debugging a task. The second type is 
a TAF dump, a dump of all or part of the TAF field 
length. A TAF dump contains pertinent information 
that is not contained in a task dump. This section 
describes the methods used to obtain both types of 
memory dumps. 


TASK DUMP 

The central memory dump (OIDUMP) request dumps 

central memory according to the parameters specified 
In the direct subsequent dumps (DSDUMP) request. 
Parameters specified on the DSDUMP request are used 
under three circumstances. 

• When a fatal task error occurs. 

• When a default value is requested in a 

CMDUMP request* 

• When a parameter is in error in a QIDUMP 

request. 

The purpose of DSDUMP and CMDUMP is to aid 

applications programmers in debugging their tasks. 
These dump requests allow users to dump any portion 
of their programs. The user specifies the first 

word address (fva) and the last word address (Iwa) 
of Che area to be dumped. The exchange package may 
also be dumped by setting the proper paramecer(s) to 
a nonzero value. 

The DSDUMP request sets up default values for 

subsequent CMDUMP requests made by this task and all 
linked tasks in this transaction (those called by 
CALLTSK without CEASE). DSDUMP does not cause a 
dump; it only sets parameter values that can be 

defaulted as a result of a CMDUMP request. 

A hierarchy of parameter values allows users to 
default any parameters they want on DSDUMP or CMDUMP 
calls. At system assembly time, default values are 
assembled for each parameter. These default values 
can be changed via a K display command* In 
addition, if users want to change any default 

parameter values for their tasks, they may do so by 
using DSDUMP requests* 

This hierarchy of default values works In the 
following manner. The CMDUMP request causes a dump 
according to the parameters it specifies. If a 
default option is requested, the system determines 
if a DSDUMP request has been made for this 
transaction. If a DSDUMP request has been made and 
if the corresponding parameter value has been 
supplied, this value Is used. If DSDUMP requests 
have not been specified, a new default value, the 
system default value for this parameter, is used. 


All task dumps, whether due to an aborted task, an 
abnormal CEASE request, or a CMDUMP request, are 
handled in the same manner. A job file is created 
containing the information to be dumped in binary 
format, as well as a command record* The transaction 
executive issues a ROUTE request releasing the job 
file to the input queue for batch processing. A 
program called RTSDMP is used, either to generate 
listable output from the binary file, or to transfer 
it to a direct access permanent file. 


When dumping to an output queue, a ROUTE command Is 
included in the command record to direct the output 
produced by KTSDMP to the proper queue. 


A USER command is always included, thus enabling 
KTSEMP to attach the appropriate file if the dump is 
destined for a user's file. In this case, KTSDMP 
appends the binary information to the end of the 
permanent file* This method of handling dumps 
relieves the transaction executive of time-consuming 
processing that is better performed by a utility* 


DSDUMP REQUEST 

The DSDUMP request allows the applications 
programmer to change any of the default values of 
the QiDUMP request. The DSDUMP does not cause a 
duap in itself, except when the system detects an 
error (that is, aborts). Any default values on the 
DSDUMP are satisfied from the general default 
values. All six parameters are required. If an 
error occurs on any DSDUMP parameter, the task is 
aborted. 


The format is: 

COBOL 

EfTTER DSDUMP USING fwa Iwa ep db oq qd. 

fwa Computational-I item that specifies 
beginning address of task memory to 
be dumped; legal values are 0^fwa<FL 
(field length). 


If fwa is negative, the default 
value is used. 


Iwa Computetlonal-1 item that specifies 

last word of task memory to be 
dumped; it must be greater than 
fwa. If zero is specified, no dump 
of task memory occurs. If Iwa 

equals FL, the dump extends to the 
end of the field length. If Iwa is 
negative, the default value is used. 
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ep 


db 


oq 


qd 


Computational-1 Item that specifies 
exchange package option* 

0 Do not dump exchange package. 

> 0 Dump exchange package* 

< 0 Use default value* 

Performs no function* Retained for 
compatibility with previous releases. 

Cbmputatlonal-1 item that specifies 
output queue option* 

< 0 Use default value (refer to 

following note). 

0 Dump to local batch output 
queue* 

1 Dump to remote batch output 
queue* 

2 Dump to user permanent file 
defined under data base user 
nuaber* 

Queue destination option; value 
depends on oq selection* 


21 

0 


l2 

Printer id» specified as a 
computational*! number* If 
negative, use default value 
(refer to following note). 


User 

number 

Direct 
access 
permanent 
file name 


^ A valid name 
specified In 
display-coded, 
left-justified 
^characters 
with either 
blank or 
binary zero 
fill. 


NOTE i 


If either oq or qd Is negative, the 
default value will be used for both, 
regardless of the option selected for 
the other* 


ep 


db 


oq 


qd 


If zero Is specified, no dump of 
task memory occurs* If Iwa equals 
FL, the dump extends to the end of 
the field length* If Iwa Is 
negative, the default value is used. 

Integer that specifies the exchange 
package option* 


0 Do not dump exchange package* 
> 0 Dump exchange package* 

< 0 Use default value* 


Performs no function* Retained for 
compatibility with previous releases. 

Output queue option. 

< 0 Use default value (refer to 
following note)* 

0 Dump to local batch output 
queue* 

1 Dump to remote batch queue* 

2 Dump to user permanent file 
defined under data base user 
ntmiber* 


Queue destination option; 
depends on oq selection* 


value 


oq qd 

0 Integer specifying printer 
id* If negative, use 
default value (refer to 
following note). 


1 User 
name 


Direct 
access 
permanent 
file name f 


A valid name 
specified In 
display-coded, 

I left-justified 
^characters with 
either blank or 
binary zero 
fill. 


NOTE 


FORTRAN 

CALL DSDUMP(fwa,lwa,ep ,db ,oq ,qd) 

fwa Octal integer that specifies the be¬ 
ginning address of task memory to be 
dumped; legal values are zero£fwa<FL 
(field length). 

If fwa is negative, the default 
value is used. 

Iwa Octal Integer that specifies the 
last word of task memory to be 
dumped; must be greater than fwa. 


If either oq or qd is negative, the 
default value will be used for both, 
regardless of the option selected for 
the other* 


COMPASS 

DSDUMP address 

address Address of a parameter table* The 
table has the form shown In figure 
6 - 1 . 


•2 
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c Set to one for exchange package default value. 

Last word of task memory to be dumped; must be greater than fwa. If zero is 
specified, no dump of task memory occurs. If Iwa equals FL, the dump extends to 
the end of the field length. If Iwa is negative, the default value is used. 

fwa Beginning address of task memory to be dumped; legal values are zero through 

lwa-1. 

If fwa is negative, the default value is used.t 

qd Queue destination option; the value depends on the oq selection as shown 

following the oq description. 

oq Output queue option. 

0 Dump to local batch output queue. 

1 Dump to remote batch output queue. 

2 Dump to user permanent file defined under data base user name. 
Interdependency between oq and qd is defined as follows: 

oq 2 ^ 

0 Printer id, specified as binary number, right-justified within word; if 
negative, use default value. 

1 User name. \ A valid name specified in display-coded, 

I left-justified characters with either blank 

2 Direct access | or binary zero fill, 

permanent file name. ) 


t Default values are specified by setting the sign bit. 

Figure 6-1. DSDUMP Parameter Table 


CMDUMP REQUEST 

The CMDUMP request allows the applications progranmer 
to dump memory In the task^s field length to a selec¬ 
ted output queue (and logical device). The first six 
parameters are required. If there is an error on or 
a default of any parameter specified by CMDUMP, the 
parameter value of the DSDUMP call Is used. 


The format is: 

COBOL 

ENTER CMDUMP USING fwa Iwa ep db oq qd. 

The descriptions of the first six parameters are 
the same as those for the DSDUMP request. 

FORTRAN 

CALL CMDUMP(fwa,lwa,ep,db,oq,qd) 

The descriptions of the first six parameters are 
the same as those for the DSDUMP request. 

COMPASS 

CMDUMP address 


address Address of a parameter table in 
the form shown in figure 6-2. 

I notTI 

The manner In which the hierarchy of 
default values works was previously 
described. However, In the special 
case of output queue and queue 
destination (oq and qd parameters). 

If either parameter is defaulted, the 
next pair of output queue and queue 
destination parameters is obtained 
from the next level of the default 
hierarchy. 

There is also a special case 
concerning errors in a CMDUMP 
request. If the parameter in error 
is the output queue value, the system 
is unable to route the dump as the 
user wants. If this error is on a 
CMDUMP request, the system attempts 
to dump according to the 
corresponding DSDUMP output queue and 
queue destination parameters. If 
that is not possible, the general 
system values are used. 
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tXhe descriptions of the first five parameters are the same as those shown In figure 6-1. 


Figure 6-2. GMDUHP Parameter Table 


K.DSDUMP COMMAND 

The K.DSDUMP command can be used under the K display 
for the transaction executive control point to reset 
default dump parameters. The parameters can be 
given in any order and only those parameters to be 
changed need to be given. 

The format when entered from the console Is: 

K.bS DUMP,FW=fwa,LW*Iwa,EP=ep,0Q»oq^ Q0=qd. 

The values of these parameters are as specified for 
the DSDUMP request made by a task. These system 
dump parameters can be examined by checking the 
K display for control points* 


KTSDUMP UTILITY 

KTSDMP can be called via a command to form llstable 
memory dumps. The Input flies can be created by the 
transaction executive or by any other program. The 
following Items can be listed. 

• Central memory of a task or program. 

• Exchange package and control point area of a 
task. 

• Communication block of a task (always 
present)* 

The format Is: 

KTSDMP (lfni,lfn2,P,0) 


Ifni 

Input 

file 

name; 

if 

absent 

default 

is INPUT. 



lfn2 

Output 

file 

name; 

If 

absent 


default Is OUTPUT. 

P If P Is specified, append file 

lfn| on direct access permanent 
file lfn 2 « The job must be 
running with the proper user 
name and file lfn 2 must be 
defined. End-of-file Is not 
copied to lfn 2 * 

0 If 0 Is specified, the dump is in 

octal format. If 0 is omitted, 
the dump is in octal and 6-bit 
display code format, with the 
6-bit display code format to the 
right of the octal format. 


If the P option is used, an Installation may keep a 
running stack of memory dumps to be listed 
selectively at some later time. To list all dumps 
on the permanent dump file, the file should be 
attached and KTSDMP executed. All dump records on 
the file are processed. To list only selected 
dumps, the permanent file should be attached and the 
selected dump records extracted using the GTR 
command (refer to the NOS 2 Reference Set, Volume 
3). KTSDMP should be executed to process the output 
file from the GTR command. 


The user must specify the 0 option when Issuing the 
KTSDMP command from a terminal; If the 0 option is 
not specified, execution is terminated, and KTSDMP 
issues the following message. 

DISPLAY DUMP NOT AUGWED TO TERMINAL. 


TASK DUMP FORMATS 

Figure 6-3 contains the formats of the dumps 
provided. The leftmost date and time in the header 
are the date and time of creation of the KTSDMP 
Input file* The current date and time follow. The 
task control point area dump appears only when the 
exchange package dump is requested. The exchange 
package dump, task control point area dump, and the 
communication block dump all appear on the same page 
when the exchange package dump is requested. 


TAF DUMP 

A TAF dump Is a dump of all or part of the TAF field 
length. The user Initiates a TAF dump using the 
K.DUMP command. A TAF dump assists the systems 
analyst in detecting system errors that do not abort 
TAF. When a task detects an error in TAF, a TAF 
dump might be needed because there is significant 
information outside the task field length that is 
not contained in a task dump. 


A task initiates a TAF dump using the KPOINT request 
(refer to KPOINT Request in section 2) in 
conjunction with the K.DUMP command. The K.DUMPLIM 
command sets a global limit on the number of K.DUMP 
commands that tasks can Issue. A task uses the 
KPOINT request in conjunction with the K.DUMPLIM 
command to set the global task dump limit (GTDL). 
The remainder of this section describes the K.DUMP 
and K.DUMPLIM commands. 
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KTSEMP-taskname yy/i/xmj dd.hh,mm.ss . 

EXCHANGE PACKAGE. 

Exchange package dump 
TASK CONTROL POINT AREA. 


Task control point area dump 
CONMONICATION BLOCK DUMP FROM fwa TO Iwa 

PROGRAM taskname SEQUENCE number ADDRESS xxxx 
Communication block dump 

KTSDMP-taskname yy/mm/dd.hh.mm .ss . 

DUMP FROM fwa TO Iwa 
Memory dump 

KTSDMP-taskname yy/mm/dd .hh .mm.ss . 

DUMP FROM fwa TO Iwa 


Memory dump 
KTS DMP-ta skname 


yy/mm/dd .hh .mm .ss . 


yy/mm/ dd .hh .mm.ss. 


yy/mm/dd.hh .mm .ss . 


yy/mm/dd «hh.mm .ss • 


yy/mm/ dd .hh .mm .ss . 


Figure 6-3. KTSDMP Format 


K.DUMP COMAAAND 

The K.DUMP command Initiates a *dump of all or part 
of TAF. The user can specify the first word address 
(fwa) and the last word address (Iwa) of the memory 
to be dumped. 

The command formats when Issued from a task are: 

DUMP,fwa»lwa. 
or 

DUMP,Iwa. 
or 

DUMP. 

fwa Octal address of the first word of 

memory to be dumped; legal values 
are Oj<fwa^lwa. The default Is 
zero. This parameter cannot be 
used unless the Iwa parameter Is 
also used. 

Iva Octal address of the last word of 

memory to be dumped; legal values 
are fwa<lwaO77777. The default 
is 377777. 

If both parameters are omitted, the entire field 
length Is dumped. The output of the dump is routed 


to a printer that has an identifier of zero. A 
header page precedes the dump; it lists the date and 
time of the dump and the name of the task that 
issued the dump. Also listed are the instructions 
that the dump be given to the TAF central site 
systems analyst. 


K.DUMPUM COMMAND 

The K.DUMPLIM command sets the GTDL. The GTDL 
specifies the number of K.DUMP commands that tasks 
can issue. 

The command format when issued from a task is: 

DUMPLIM,n. 

n The decimal ntmber of TAF dumps 

that tasks can issue. The 
default is zero. The maximum 
value is 9999999. The user 
specifies octal by using a 
postradix of B. 

The initial value for the GTDL is zero. When the 
GTDL is zero, no TAF dumps from tasks are allowed. 
The GTDL must be set to a value greater than zero 
for TAF dumps from tasks to occur. Each TAF dump 
(where the task does not abort) causes the GTDL to 
be decreased by one. This command does not affect 
the execution of task dumps • 
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APPLICATIONS INTERFACE FOR AUTOMATIC RECOVERY 



This section describes automatic recovery as It 
affects task writing. Recovery-related Information 
applicable to the applications prograomer Is covered* 
Additional information of interest to the system in¬ 
stallation and maintenance personnel can be found In 
section 8 of this manual. 


PURPOSE 

The purpose of the TAF automatic recovery feature is 
to enable site personnel to design TAF transactions 
that can recover quickly and predictably from system 
failures, and maintain the data base In a consistent 
state across failures. Terminal operators will be 
able to determine the status of transactions upon re¬ 
covery so the possibility of Issuing a double update 
to the data base or of missing a data base update is 
greatly reduced. The recovery will be automatic In 
the sense that TAF and the data manager will deter¬ 
mine which data base updates to roll back, and which 
transactions to restart upon Initialization after a 
failure. Site personnel need only select recovery 
mode when brlngi^ TAF back up. 


CONCEPTS 

There are two basic components to automatic recovery: 
data base recovery and transaction recovery* Data 
base recovery ensures that the data base Is always In 
a consistent and known state, even If a failure occurs 
during a run unit. Transaction recovery automatically 
reruns recoverable run units that were active at the 
time of a failure. It also guarantees that the termi¬ 
nal operator will receive a confirmation message when 
the run unit completes. 


NAMED-TRANSAOIONS AND RUN UNITS 

A transaction Is a task or a series of linked tasks* 
The linking can be internal to the tasks using the 
CALLTSK and/or CALLRTN requests, or external to the 
tasks using the LIBTASK /tname directive. Refer to 
section 10 for a complete description of this direc¬ 
tive. Transactions defined using the /tname directive 
are referred to as named-transact Ions. In most dis¬ 
cussions in this section and throughout this manual. 
It Is not necessary to distinguish between the coding 
that comprises a transaction and the execution of that 
code. However, when the distinction Is Important, the 
execution of a transaction is referred to as a run 
unit. The terms executing transaction, running trans¬ 
action, and run unit can be used Interchangeably. A 
run unit Is recoverable only If It Is the execution of 
a named-transaction and the RC parameter was specified 
when the named-transaction was defined. There are 
differences In terminology between CDCS and TAF. 
What Is referred to as a transaction In TAF Is always 
called a run unit In CDCS. The processing bounded by 
the begin statement (DB$BEG or BEGTRAN) and the commit 
statement (DB$CMT or COMMITRAN) is referred to as a 
transaction In CDCS* Each of these transactions has 
an id supplied within the application. 


DATA BASE RECOVERY 

Automatic data base recovery Is available to 

transactions using the CDCS and/or the TAF/CRM Data 
Managers. Data base recovery Is based on the 

concept of a begin-coomlt sequence. A begin-commit 
sequence Is a portion of a transaction, designated 
by the programmer, that contains one or more data 
base updates that are to be treated as a unit. 
Should a failure occur during a recoverable run 
unit, data base recovery ensures chat all the 
updates within a begln-commlt sequence are performed 
or that none of them are. It also provides a means 
by which the transaction can determine which 
begln-commlt sequences had successfully completed 
prior to failure so that on restart, the transaction 
can avoid performing those updates a second time. 

Data base begln-commlt sequences are Identified in a 
transaction by placing a data base BEGIN request at 
Che beginning of the sequence and a data base COMMIT 
request at the end of the sequence. (The BEGIN and 
COMMIT requests have different forms depending on 
Che data manager and source language being used.) 
The data base BEGIN request Includes a parameter for 
assigning an identifier to the begln-commlt 
sequence. This Identifier (selected by the 

programmer) Is preserved across failures and can be 
retrieved upon restart to enable the transaction to 
determine how far processing had gone prior to 

failure. The data base COMMIT request tells the 

data manager that the updates are to be made 

permanent. A failure before a data base COMMIT 

causes all updates for this sequence to be rolled 
back. This means that the data base Is returned to 
the state It was In at the time the BEGIN for this 
sequence was Issued* If a failure occurs after a 
data base COMMIT, all updates for the committed 
sequence are retained. A transaction can terminate 
an update sequence without committing the updates by 
Issuing a data base FREE request* 


TRANSACTION RECOVERY 

Transaction recovery restarts recoverable run units 
that were active at the time of a system or terminal 
failure. Transaction recovery also uses the concept 
of a begln-commlt sequence. With transaction 
recovery, the BEGIN Is Implicit In the Initiation of 
any recoverable run unit. The transaction COMMIT is 
specified with a SECURE request Indicating that the 
work of the transaction is complete. The SECURE 
request should Immediately precede the last data 
base commit request In the transaction. 


When a recoverable run unit Is initiated from a 
terminal or a batch job (via a BTRAN request), TAF 
logs the Initial input on the communication recovery 
file. If a failure occurs during the run unit, auto¬ 
matic recovery takes place when TAF is subsequently 
brought back up. At that time the data base recovery 
routine is called in to restore the data base to a 
consistent state. 
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Then, the transection recovery routine examines all 
run units that were active at the time of failure to 
determine which should be rerun. For run units 
Initiated from a terminal, a flag is set In the 
terminal status table and the decision Is postponed 
until the terminal logs back In. For run units 
initiated by BTRAN, the decision and restart. If 
necessary, are made Immediately. This decision 
process Is summarized In the following steps. 

1. Is this transaction designated as recoverable? 

YES NO 

Go to step 2* Do not rerun. 

2. Does this transaction use CDCS? 

YES NO 

Rerun. Go to step 3. 

3. Was the transaction SECURE at the time of 
failure? 

YES NO 

Go to step 4. Rerun. 

4* Did an Incomplete begln-commit sequence exist 
at the time of failure? 

YES W 

Rerun. Send SECURE 

message. Do 
not rerun. 


CODING 

Automatic recovery requires a transaction to contain 
a specific set of requests In a predetermined 
order. The following outlines show some suggested 
structures for recoverable transactions. 

The OPEN, CLOSE, and LOCK requests need not appear 
in the places shown* The restrictions placed on 
these requests by TAF/CRM and CDCS automatic 
recovery are as follows; 

• OPEN 

An OPEN request cannot occur within a 
begln-commlt sequence In a transaction using 
CDCS. 

• CLOSE 


begin request must be reissued and the 
update process restarted. Therefore, 
whenever possible, TAF/CRM transactions 
should request the record locks before 
making the DBEGIN request. For transactions 
using CDCS, the lock request Is Implicit In 
the record READ. 


CODING STRUCTURES FOR DATA BASE RECOVERY ONLY 


Transactions Using CRM 

A transaction that uses the CRM Data Manager may be 
structured as follows* In addition, the recovery 
parameter must be specified on the xxJ file CRM 
statement for any file to be updated by this 
transaction. Although only one begin-commit 
sequence Is shown, actual transactions can contain 
as many separate (nonnested) begln-commlt sequences 
as desired. Multiple data base updates are 
permitted within a begln-commlt sequence. 

OPEN requestCs). 

Record lock request(s). 

DBEGIN request. 


(data base processing/updating) 


DBCOMIT or DBFREE request. 
CLOSE request. 


TAP Transoctions Using CDCS 

TAF transactions using the CDCS data management 
system may be structured as follows to take 
advantage of data base recovery. Although only one 
begln-commlt sequence Is shown, actual TAF 
transactions can contain as many separate 
(nonnested) begln-commlt sequences as desired. 
Multiple data base updates are permitted within a 
begln-commlt sequence. 


In all the CDCS outlines in this section where a 
FORTRAN request name Is different from the 
equivalent COBOL request name, the FORTRAN name is 
given In parentheses. 

OPEN file request(s)« 

DB$BEG (BEGINTRAN) request. 


A CLOSE request cannot appear within a 
begln-commlt sequence In any transaction. 

(data base processing/updating) 

• LOCK 

A record lock conflict within a begln-commlt « 

sequence causes all updates In the sequence DB$CMT (COMMITTRAN) or DB$DROP (DROPXRAN) request, 

to be rolled back. If this happens, the CLOSE file request(s). 
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CODING STRUCTURES FOR TRANSACTION RECOVERY 


(data base processing) 


Transactions Using CRM 

Recoverable transactions using the CRM Data Manager 
can be divided into two categories: single 
begin-connnit sequence transactions and multiple 
beg ln<-commlt sequence transactions* A single 
beg in-commit sequence transaction needs only to 
include a SECURE request immediately before the 
C0J®1IT request. If a failure occurs before the 
COMMIT request is successfully executed, the data 
base will automatically be rolled back and the 
transaction rerun at recovery time. A multiple 
beg in-commit sequence transaction must first 
determine if recovery is in progress. If it is, the 
transaction must then discover which was the last 
successfully committed beg in-commit sequence and 
begin processing with the following begin-commit 
sequence. For this purpose, the data base BEGIN 
requests require a user-supplied identifier to be 
included as part of the request. All identifiers 
used within a single transaction must be unique for 
the restart point to be unambiguous. 


Single Begin-Commit Sequence Transaction 
OPEN files. 

Record lock request(s). 

DBEGIN request* 


(data base processing) 


SECURE request. 

DBCOMIT request. 

CLOSE request. 

transaction CEASE — SECURE message is sent to 
terminal* 

In the preceding transaction, if a failure 
interrupts processing any time prior to the DBCOMIT 
request, TAF automatic recovery reruns the 
transaction from the beginning. If a failure 
interrupts processing after the DBCOMIT request, 
automatic recovery only sends the SECURE message to 
the terminal. 


Multiple Begin-Commit Sequence Transaction 


OPEN files. 

TSTAT request using keywords RESTART, OLDID. 
If RESTART value is aero or OLDID value is 
blank, begin processing at SEQNl. 

If OLDID is SEQNl 

begin processing at SEQN2. 


If OLDID IS SEQN(n-l) 

begin processing at SEQNn* 

Processing Module(s) 


SEQNl. 

Record lock request(s). 

DBEGIN request, begin-commit id » SEQNl* 
Perform processing module(s). 

DBCOMIT request. 

SEQN2. 

Record lock requesc(s). 

DBEGIN request, begin-commit id » SEQN2. 
Perform processing module(s). 

DBCOMIT request. 

SEQN3. 


SEQNn. 

Record lock request(s). 

DBEGIN request, begin-commit id » SEQNn. 
Perform processing module(s). 

SECURE request* 

DECGMIT request. 

CLOSE files. 

transaction CEASE — SECURE message is sent to 
terminal• 


TAF Transactions Using COCS 

A recoverable TAF transaction using CDCS must first 
determine if recovery is in progress. If it is, the 
TAF transaction must determine the last successfully 
committed begin-commit sequence. This is necessary 
even for single begin-commit sequence transactions 
because all recoverable run units using CDCS are 
rerun during recovery regardless of whether the last 
begin-commit sequence was successfully committed. 
The failure may have occurred after the COMMIT 
request and before the transaction CEASE. Rerunning 
from the start would cause a double update for the 
transaction. The transaction must begin processing 
at the first begin-commit sequence following the 
last successful COMMIT. If the final begin-commit 
sequence was successfully committed prior to 
failure, the transaction need only retrieve and send 
the SECURE message to the terminal. 


Figure 7-1 shows the structure of a recoverable, 
multiple begin-commit sequence transaction that uses 
CDCS. The decision process that determines where to 
begin during recovery is shown in expanded form for 
clarity. The use of subscripted variables for 
begin-commit ids would allow for condensed code in 
the case of a large nunber of begin-commit sequences. 


CDCS applications programmers should be aware of 
some terminology differences between TAF automatic 
recovery documentation and CDCS automatic recovery 
docunentation. The term transaction in CDCS 
docimentation refers to what TAF documentation calls 
a begin-commit sequence; that is, all processing 
starting with a data base begin request and ending 
with the corresponding data base commit request. 
Similarly, CDCS documentation uses the term 
transaction-id to refer to what TAF documentation 
calls the begin-commit id. 
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OPEN file(s). 


TSTAT request, Ke3rword RESTART. 


If RESTART value is zero 

(If not being recovered.) 

DB$GTID (ASSIGNID) request 

(Get new RESTART-ld.) 

RPUT request 

(Save new RESTART-id on CB^.) 

begin processing at SEQNl. 

(Skip to first begln-commit sequence.) 

ELSE 


RGET request. 

(Retrieve old RESTART-id from CRF) 

DB$ASK (FINDTRAN) request. 

(Get id of last committed begln-commit 

If the begin-commit id is blank 

sequence. This also assigns the old 

begin processing at SEQNl. 

RESTART-id to this transaction.) 

If the begln-commit id is SEQNl 


begin processing at SEQN2. 


IF the begln-commit id is SEQN2 


If the begln-commit id is SEQN(n-l) 


begin processing at SEQNn. 


If the begln-coomit id is SEQNn or ********** 


begin processing at WRAP-UP. 


Processing Module(s) 


• 

(data base processing/updating) 


SEQNl. 


DB$BEG (BEGINTRAN) request, begin-commlt id ■ SEQNl. 


Perform processing module(s). 


DB$CMT (COMMITRAN) request. 


SEQN2. 

• 


• 

SEQNn. 


DB$BEG (BEGINTRAN) request, begln-commit id » SEQNn. 


Perform processing module(s). 


SECURE request. 


DB$CMT (COMMITRAN) request. 


RESTART-value equal to zero. 


WRAP-UP. 


If RESTART value is not zero 


RSECURE request 

(Retrieve SECURE message from CRF.) 

SEND request. 

(Send SECURE message to terminal.) 

CLOSE request(s). 


Transaction cease. 



Figure 7-1. Recoverable TAF Transaction Using CDCS 


TERMINAL RECOVERY CONSIDERATIONS 

If a communication subsystem, TAF, or system failure 
occurs, an application cannot assume that the termi¬ 
nal contains any particular set of data. The last 
message may not have been transferred to the termi¬ 
nal, or the terminal operator may not have noticed 
the message. Also, login procedures or terminal 
failures may destroy the screen. 


Terminal recovery is also dependent upon the type of 
terminal and the form used on the terminal. On hard 
copy terminals, the terminal may not need all the 
data resent. In fact resending the data may spoil 
the form. On cathode ray tubes (CRTs), the data 


entered by the operator may need to be sent after 
recovery to indicate what still needs specification. 

Applications must design their terminal dialog so 
that the operator has no doubts about the state of 
the run unit by sending a final message via SECURE 
indicating unmistakably that the run unit was suc¬ 
cessfully completed. The transaction system guaran¬ 
tees that the operator will see this message in all 
cases when the run unit completed successfully; 
otherwise, the operator might reenter the transaction 
causing a double update of the data base. 

Applications that require many terminal interactions 
must reconstruct the screen from the data base upon 
recovery. 
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CALLTSK WITHOUT CEASE AND RECOVERY 

A CALLTSK without CEASE starts a new run unit. This 
new run unit is not recoverable. It will be 
restarted only if the calling task is part of a 
recoverable run unit and the task makes the CALLTSK 
request again upon restart. 

Care is necessary when using SECURE, RSECURE, RFUT, 
and RGET from run units initiated by CALLTSK without 
CEASE. Such run units may write or read the same 
recovery data being written or read by the 
originating run unit. 


MULTIPLE DATA MANAGER USE 

Correct recovery cannot be assured for nested or 
overlapping begin-commit sequences using both CDCS 
and CRM. A transaction may use both CDCS and CBM 


provided that begin-commit sequences are neither 
nested nor overlapping. 


TOTAL DATA MANAGER USE 

The TOTAL Data Manager does not use the concept of 
begin-commit for data base recovery. Applications 
using this data manager, however, may implement data 
base recovery using current TOTAL features and TAP 
automatic recovery. If TAF automatic recovery is 
installed, such tasks may use any of the requests 
described in section 2 of this manual, including the 
application recovery requests. 

During recovery, transactions that do not use CRM or 
CDCS and that were active at the time of failure are 
rerun unless the SECURE request data resides on the 
communication recovery file. If the SECURE message 
is present, the transaction is not rerun but the 
SECURE message is sent to the terminal. 
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This section contains recovery information of inter¬ 
est to persons responsible for the installation and 
maintenance of the transaction subsystem. 


RECOVERY OVERVIEW 

The TAF recovery package consists of two major compo¬ 
nents; transaction recovery and data base recovery. 
Data base recovery can be further subdivided into the 
automatic component and the batch component. The 
integrated system works like this: 

A transaction is declared to be recoverable when it 
is added to the application task library. The data 
managers (CBM and CDCS) provide methods of declaring 
data files recoverable. Upon initiation of a recov¬ 
erable transaction, ITASR schedules the transaction 
via a CALLTRN request. Then the original input (that 
is, the transaction name and all unsolicited data) is 
logged to the communication recovery file before the 
transaction begins execution. The transaction must 
indicate to the data manager that it wishes to open 
a begln-commit sequence by making a data base BEGIN 
request. When the transaction requests to update a 
data file, the following occurs. 

• The record as read from the data file (the rec¬ 
ord in this state is called the before Image) 
is logged to a before image recovery file, also 
known as the before image log file. 

• The record is processed by the transaction. 

• The updated record (called the after image) is 
logged to an after image recovery file when the 
program makes a write, rewrite, or delete re¬ 
quest. The updated record is also written to 
the data file at this time. 

After an update or a series of updates, the transac¬ 
tion Indicates to the data manager that it wishes to 
close the begln-conmit sequence by making a data base 
COMMIT request. If the transaction does not intend 
to open another begin-commit sequence, it indicates 
to TAF that its work is done by Issuing a SECURE re¬ 
quest just prior to the COMMIT request. TAF logs a 
message associated with the SECURE request to the CRF 
and sends this message to the terminal when the final 
transaction CEASE request is processed. 

If a failure occurs prior to the BEGIN request, the 
data base is unaffected and the transaction is re¬ 
started upon recovery using the original data logged 
on the CRF. 

If a failure occurs between the BEGIN and COMMIT 
requests, the data manager rolls back the data base 
by applying the before Images from the before image 
recovery file (BRF) to the affected data files. The 
data base is then in the same state as it was at the 
beginning of the begin-commit sequence. The trans¬ 
action is restarted upon recovery using the data on 
the CRF. 


If a failure occurs after the COMMIT request, the 
data base is not rolled back, all updates become per¬ 
manent when the COMMIT is processed. Whether the 
transaction is restarted depends upon the data mana¬ 
ger being used. CDCS transactions are restarted if a 
failure occurs any time prior to the final transac¬ 
tion CEASE request. CRM transactions are rerun un¬ 
less both a COMMIT and SECURE request have been suc¬ 
cessfully issued. The applications tasks must be de¬ 
signed to handle cases where restart can occur after 
a COMMIT has been successfully executed. Refer to 
section 7 for some suggested transaction structures. 

A BRF file is used repeatedly by the application. 
Only the before images for the current begin-commit 
sequence need to be saved so each new begin-commit 
sequence can overwrite the previous one. 

An after image recovery file (ARF) is continuous. 
New after images are written sequentially until the 
file is full. At that time, logging is switched to 
a second ARF while the after images from the first 
ARF are dumped to tape. 

The ARF files are not used for automatic recovery. 
They provide a backup in case a CRF, BRF, or data 
file becomes damaged. If this happens, the data ad¬ 
ministrator can use batch recovery to reload the data 
file(8) from the dump tape and apply, after images 
from an ARF dump, thus restoring the data base to a 
correct state as of any desired point in time. 

The function performed by each of the recovery compo¬ 
nents are as follows. 

• Transaction recovery 

- Logs the initial input to the CRF. 

- Logs and sends the SECURE message. 

- Restarts recoverable transactions after a 
failure. 

• Data base recovery 

- Automatic component 

• Rolls back updates in uncommitted 
begin-commit sequences. 

• Logs before Images to the BRF. 

• Logs after images to the ARF. 

. Switches after Image logging when an 
ARF is full and submits a batch job to 
dump the full ARF to tape. 

- Batch component 

. Dumps full ARFs to tape. 

. Dumps data files to tape upon request. 


60459500 A 


8-1 


• Restores data base files from data file 
and ABF tapes. 

• Maintains a directory of dumped files. 


The nomenclature used here is specific to the TAF/CRM 
Data Manager. CDCS automatic recovery uses similar 
concepts but different terminology. The details 
associated with data base recovery are docimented in 
the respective data manager reference manuals. The 
remainder of this section covers the details of 
transaction recovery. 


HARDWARE CONFIGURATION CONSIDERATIONS 

Recovery cannot succeed if failures affect more than 
one component of the recovery system. For example» 
if a single hardware failure destroys both the recov¬ 
ery files and the data base, there is no recovery 
other than to restore the data base from a backup 
copy (file dump). For this reason, the data base 
files, the communication recovery files, the before 
image recovery files, and the after image recovery 
files should be assigned to physically separate 
devices. Also, the backup directory file for batch 
recovery should not reside on the same device as the 
ARFs. 

The dump tape storage area should be physically 
separate from the area housing the disk drives. 

Automatic recovery also depends on the integrity of 
single input/output operations. An on-line motor- 
generator is essential to ensure that disk operations 
underway at the time of a power failure have time to 
complete correctly. 

Performance Improvements through the use of multiple 
CRFs and BRFs (TAF/CRM only) wiU be realized only if 
each additional file resides on a separate device. 


INSTALLATION 

A procedure file for TAF initialization and recovery 
is presented in the NOS 2 Installation Handbook. 

Transaction recovery is enabled or disabled by the 
installation parameter IPTAR. If IPTAR is set to 
one, transaction recovery is enabled; if IPTAR is set 
to zero, transaction recovery is disabled. 

If recovery is disabled, these requests will not be 
honored in recovery mode: 

CALLTRN For logging of input on CRF. 

RERUN 

RGET 

RPUT 

RSECURE 

SECURE 

TINVOKE 

TSTAT Except for keywords USER and NEXT. 

WSTAT Except for keywords STEP (*»8 or «9) 

and USER. 


A number of other installation parameters have an 
effect on recovery. Refer to the NOS 2 Installation 
Handbook for details. 


TAF K DISPLAY 


INITIAL K DISPUY 

Three K display commands are available to perform 
recovery-related functions: K.INT, K.ERO, and K.REC. 


K.INT Command 

The K.INT command specifies which recovery file(s) 
are to be initialized. This is the only means of 
inltalizing a CRF. Files listed on a RECOVER state¬ 
ment in the TCF and on this command will be initial¬ 
ized. Files listed on a RECOVER statement but not on 
this command will be used for recovery. The INT com¬ 
mand also specifies whether CRM data base recovery 
files (ARFs and BRFs) are to be initialized or recov¬ 
ered. When used for CRM recovery files, this command 
is valid regardless of TAF installation options. 

The format is: 

K.INT-type,fileid 

type File type. The options are: 

CRF Command relates to the 

communication recovery 
file. This option valid 
only if installation 
parameter IPTAR - 1. 

CRM Command relates to CRM 

recovery files. 

fileid File identifier. The options are: 

digits .Each digit in the string 

0-7 specifies a CRF to be 

initialized. The digit 
corresponds to the id 

parameter on the RECOVER 
statement in the TCF. 
This option is not valid 

if type is CRM. 

ALL If type is CRF, all CRFs 

listed in TCF RECOVER 

statements are to be 

initialized. If type is 
CRM, all CRM after image 
recovery files are to be 
initialized. 


I note I 

This option must be used with caution 
as the CRM data base update history 
currently residing on the recovery 
files will be lost. 


NONE If type is CRF, no CRF is 
to be initialized (all 
CRFs listed in TCF RECOVER 
statements are to be re¬ 
covered) . If type is CRM, 
no CRM recovery files will 
be initialized. NONE is 
the default for both 
values of type. 
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K.ERO Command 

The K*ERO cocmand specifies whether to override 
certain I/O or logical errors encountered during 
processing of the communication recovery file(s)« 
The format is: 

K. ERO*CRF ,0 ption • 

option Error override option. Must be 

NO or YES. 

NO Abort if I/O or logical er¬ 
rors are encountered when 
processing the communication 
recovery file(s). This is 

the default. 

YES I/O or logical errors en¬ 
countered on a run unit 
header record will result in 
the loss of that run unit 
with no indication to the 

terminal user. The loss 
will be noted on the recov¬ 
ery report. 

I/O or logical errors en¬ 
countered on a message rec¬ 
ord within a run unit will 
result in a loss of that run 
unit. However, a status in¬ 
dicator would be set in the 
run unit header that would 
enable the terminal user to 
be informed. 

I/O or logical errors en¬ 
countered on the CRF header 
record will result In uncon¬ 
ditional abort of TAF. 


K.REC Command 

The K.REC command sets the user recovery bit in the 
terminal status table. The format is: 

I K.REC-nnn 

nnn Recovery option. Must be YES or 

NO. 

YES Set the user recovery bit in 
the terminal status table. 

NO Do not change the present 
setting of the user recovery 
bit. 


RESTART K DISPLAY 

The K display that TAF formats at initialization will 
be displayed only if a DISPLAY statement with the ON 
parameter selected appears in the TCF. Refer to sec¬ 
tion 4 for details on the DISPLAY statement. If the 
K display is brought up, the operator makes any 
desired changes and types K.GO or K.END to resume 
processing. K.STOP will abort TAFREC. 

On a level 3 deadstart, or if TAF aborts, the TAF 
procedure file automatically restarts TAF by trans¬ 
ferring control to TAFREC. TAFREC recovers the low 
CM pointers and variables that were defined at TAF 
initialization via the initial K display. 


If DISPLAY,ON is selected in the TCF, the K display 
is Issued. This display is identical to the Initial 
K display except that if any values were changed at 
initialization, the changed values are retained on 
the restarted K display. This does not apply to 
R.INT and K.ERO commands. Changed values for these 
commands are not retained after TAFREC completes. 
(This prevents inadvertent initialization of 
recovery files in a recovery situation). 


TCF/CRF RECOVERY CONSIDERATIONS 

TAF CONFIGURATION FILE 

The TCF contains several recovery-related items. 

• The RECOVER statement indicates the CRF 
identifier (zero to seven) and the size and 
number of messages that can be written to 
the CRF. 

• Default K display values can be changed by 
placing K display commands in the TCF. 

• The DISPLAY statement provides the option of 

having the K display brought up at 

initialization and recovery to allow the 
operator to override any of the default 
values. 

Details on these statements are given with the TCF 

description in section 4. 


The use of multiple CRFs is indicated by multiple 
RECOVER statements in the TCF* Each RECOVER 
statement corresponds to a separate CRF. For each 
RECOVER statement there must be a corresponding 
NETWORK statement. Refer to Use of Multiple 
Communication Recovery Files in this section and 
Communication Recovery File in section 4. 


COMMUNICATION RECOVERY FILE 


Error Override 

Certain errors on the CRF file(s) can be overridden 
by using the K.ERO K display command (refer to 
Initial K Display in this section). Input/output 
errors on the CRF encountered during the running of 
transactions cause TAF to abort and TAFREC to 
attempt recovery of all readable data from the CRF. 


File Reformatting 

TAF recovery processing reformats the CRF under the 
following circumstances. 

• If the nunber of user messages per recovery 
unit Is increased in the number parameter on 
the RECOVER statement. 

• If the size of user messages per recovery 
unit is increased in the maximumsize 
parameter on the RECOVER statement. 

• If a new user Is added to or deleted from 
the corresponding network file. 
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The RECOVER statement cannot be used to reduce the 
number or size of the user messages* The only way 
to reduce either of these is to reinitialize tbe CRT 
using the K.INT command* 

To reformat ZZCREl, TAF creates a permanent file 
named ZZCRFAl and writes the reformatted CRF to It* 
When the reformat Is complete, the old CRF (ZZCRFi) 
Is purged and the new CRF (ZZCRFAl) has Its 
permanent file name changed to ZZCRFI* 

Multiple Communication Recovery Files 

Up to eight CRFs may be active simultaneously* Each 
CRF must have a unique Identifier* Once a CRF has 
been Initialized with a given Id, It must be brought 
up with the same id* If this Is not done, recovery 
will fall* Advantages of using multiple CRFs are: 

• The Input/output associated with the CRFs is 
spread out across several disks* This 
improves performance* 

• Multimainframe recovery becomes possible. 
Refer to Multimainframe Recovery In this 
sec tlon * 


MULTIMAINFRAME RECOVERY 

The guidelines in this subsection pertain to sites 
running TAF on several mainframes* These guidelines 
are applicable if the ability to recover transaction 
processing for a downed mainframe on an alternate 
mainframe is desired. 

• Make certain that the network (NCTFl) and 
CRF (CRFl) file identifiers (1) on each 
mainframe are unique among all mainframes* 

• Allocate unique data base names to all 
applications across all mainframes* 

• Allocate recovery-related files to shared 
mass storage* 

• Define unique terminal user names across all 
mainframes* 

• When a mainframe goes down, IDLE TAF on the 
mainframe that Is to run the downed 
applications* t 

• Restart TAF with a TCF file that contains 
RECOVER statements for the recovery Ids of 
both mainframes* 

• When the downed mainframe is repaired, IDLE 
TAF on the recovery mainframe. Then bring 
TAF up independently on the two mainframes 
with the original TCFs* 

RECOVERY PROCESSING FLOW 


TAF AND SYSTEM FAILURE 

Following a TAF or operating system failure, the TAF 
initialization procedure brings TAF up in recovery 
mode* During recovery mode Initialization, TAFREC 
and TAF perform the following functions: 


• Sets the K display values to those in effect 
prior to failure* 

• Identifies the users chat were active at the 
time of failure* Active users will have the 
recovery flag (word 1, bits 0 and 53) sec in 
the terminal status table (TST). 

• Reformats the CRF if necessary (refer to 

File Reformatting under Communication 

Recovery File In this sec tlon)* 

• Prepares the TAF automatic recovery report* 

• Initializes Che transaction sequence number 
count* 

• Schedules CTASK to move begln-commit ids 

from BRF to CRF* 


BTASK Is scheduled to determine which users active 
at the time of failure were running recoverable 

BTRAN-Initiated transactions* BTASK calls CTASK to 
recover these transactions. 

Recovery for transactions being run from interactive 
terminals is postponed until the terminal logs in. 
When a terminal logs in, TAF checks the recovery 

flag (word 1, bit 33) in the terminal status table. 
If the recovery flag is set, RTASK is scheduled 

instead of ITASK. RTASK performs these functions: 

• If the run unit is not recoverable, RTASK 
sends READY to the terminal and ceases* 

• If a recoverable transaction is no longer 

rerunnable, RTASK sends a message telling 

the terminal operator 

1* that recovery has occurred, 

2* that the recoverable transaction 
will not be rerun automatically, and 

3* to enter the next input. 

This situation occurs when an input/output 

error occurred on the communication recovery 
file* Terminal operators should be 
instructed to inform the data administrator 
if this occurs since batch recovery will be 
necessary to restore the data base* 

• If the transaction SECURE request and a 

TAF/CRM COMMIT request have been 

successfully executed, RTASK sends the 
terminal confirmation message, and ceases* 
The terminal confirmation message was stored 
on Che CRF as a result of the transaction 

SECURE request* 

• If none of the preceding is true, RTASK 

calls CTASK. 

CTASK requests a new transaction sequence number and 
returns Che begin-commiC history to TAF/CRM* CTASK 
then makes a RERUN request. The RERUN request turns 
off the recovery status, retrieves terminal input 
from the CRF, and schedules ITASK using the new 
sequence number and original terminal input. ITASK 
processes the input as if it had come from the 
terminal• 


tif CDCS has been running on both mainframes and interfacing with TAF, CDCS must be dropped on the functional 
mainframe or recovery of CDCS data bases will not be possible. 
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NAM FAILURE 

If NAM fails, TAF continues running. The rollout 
table is searched to suspend transactions that were 
initiated by an interactive terminal and are waiting 
for input (the wait time in the rollout table is set 
to zero). All other active transactions continue to 
run. When a running transaction issues a network re¬ 
quest , it is suspended if recoverable and the request 
is issued to the original terminal (without recall in 
the case of SEND). If the transaction is not recov¬ 
erable, it is terminated. Suspended transactions are 
processed as follows: 

• A terminal-login-delay flag is set in the 
terminal status table to prevent terminal 
login until the next step is completed. 

• CTASK is scheduled to recover the data base 
associated with the transaction and to issue 
a WSTAT request to clear the delay flag. 

• At the time the terminal logs in, RTASK is 
scheduled either to send the SECURE message 
or to rerun the transaction. 

TAF will periodically attempt reconnection to NAM. 
When NAM becomes available, terminal operators will 
have to go through the login dialog required for the 
terminal. Upon terminal reconnection to TAF, TAF 
issues an appropriate message to tell the terminal 
operator the current state of the terminal work. 


TERMINAL FAILURE 

Processing for an individual terminal failure is the 
same as described for NAM abort. 


COCS FAILURE 

If CDCS falls, TAF continues running. When TAF 
detects a CDCS abort, it does the following to run 
units using CDCS: 

• If the run unit is recoverable, its proces¬ 
sing is suspended and an informative message 
is issued. The terminal operator may wait 
for the rim unit to be automatically rerun 
when CDCS becomes available, or may enter a 
new transaction* In the latter case, the 
run unit will not be rerun when CDCS becomes 
available * 

• If the run unit is not recoverable. It is 
aborted and an error message is issued to 
the originating terminal. 

TAF sets a flag in the CRF for suspended run units 
waiting to use CDCS. 


TAF, on a periodic basis, will check to see if CDCS 
is running and ready for transaction processing. 


When CDCS is again accepting requests, TAF will 
rerun those recoverable run units whose processing 
was suspended, as previously described. 


TASK FAILURE 

TAF does the following when a task fails: 

• TAF sends a failure or end r\m unit message 
to the data manager. The data manager rolls 
back updates in any incomplete being-commit 
sequences. 

• TAF logs the reason for the failure in the 
journal file. 

• TAF calls system task MSABT. The Control 

Data-furnlshed version of MSABT sends a 
message explaining the error condition to 
the terminal. Sites may modify MSABT to 

meet special requirements* 

• TAF reloads the task if the task has other 
run units queued on it or is central memory- 
resident. 

• Run units aborted because task failures are 
not rerun. Failure of the logged in 
terminal, NAM, or CDCS does not cause a task 
failure for a recoverable run unit. 


TAF TERMINATION 

goes through termination processing when: 

• The computer operator or terminal operator 
forces execution of a K.IDLE request. 

• The computer operator enters IDLE,TAF. 

• TAF (including any data manager in its field 
length) fails. 

• A level 3 deadstart occurs. 

When TAF receives a K.IDLE or IDLE,TAF command, TAF 
tells ITASK with an idle message. ITASK then: 

• Tells terminal users entering a new 
transaction that shutdown is occurring. 

• Prohibits new transactions from starting. 


When no more transactions are running (no 
communication blocks are reserved), TAF does an 
ENDRUN to give control to TAF2. TAF2 tells the data 
manager(s) about shutdown and records a shutdown 
status on the CRF. When TAF is subsequently brought 
up, no recovery takes place since all users were 
inactive at termination. 
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TAF AUTOMATIC RECOVERY REPORT 

This report is produced by TAFREC and placed on 
local file ZZIRRF. A site may save the report on 
permanent storage and/or route the report to a 
printer by including appropriate statements in the 
TAF procedure file* The report consists of four 
parts. 

• Part one is a copy of the TAF configuration 
file. Each directive is printed. If a 
directive error occurs, a message is printed 
on the following line. 


• Part two is an image of the initial 
K display. If the same command is used 
repeatedly, only the last Image of that 
cotomand is listed. 

• Part three is a report on each CRF 
processed. The format of this part is 
shown in figure 8-1. 

• Part four is a stanmary consisting of the to¬ 
tal number of terminals recovered, initial¬ 
ized, and deleted, and the number of concur¬ 
rent batch and BTRAN requests recovered. 


TERMINAL 

TSEQ 

TYPE 

STEP 

DATE 

TIME 

COMMENT 

TERM1 

1234 

TERM 

REC 

82/04/26. 

08.20.1. 

RECOVERED 

TER«2 

1240 

BATCH 

END 

82/04/26. 

08.20.11. 

RECOVERED 

TERM3 




82/04/26. 

08.25.20. 

INITIALIZED 

TERMA 

1251 

BTRAN 

REC 

82/04/26. 

08.20.11. 

recovered 

terminal 


Thrminal/user name. 




tseq 


Transaction 

sequence number of the last run 

unit • 


type 


It ansae tlon 

type (refer to 

TSTAT request). 



step 


Transaction 

step (refer to 

TSTAT request). 



date 


Date of last 

recorded run 

unit. 



time 


Time of last 

recorded run 

unit. 




Figure 8-1. Format of Part Three of the lAF Automatic Recovery Report 
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NETWORK FILES 
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Applications programmers should determine whether an 
analyst is preparing the network files. If so, 
applications programmers can skip this section. 


Before any transaction processing can be done, the 
terminal configuration must be defined to the 
transaction executive. This is done by the terminal 
network description file (network file). 


The NAM local configuration file is also needed to 
describe the terminal configuration. This file is 
described In the Network Products NAM 1 Network 
Definition Language Beference Manual. 


TERMINAL NETWORK DESCRIPTION FILE 

A terminal network description file consists of 
directives that describe users and their data 
bases. The directives needed consist of the //DIAL 
directive and user directives. 

The format is: 

//DIAL. 


User directives must follow the //DIAL directive. 

User directives have the form: 

/username,parameter-string. 

username A user name that is used to log 
into the network and TAF (or is 
specified in the local configura¬ 
tion file for automatic login). 
User names must be unique across 
all network files, even if they 
reside on different families. 


The possible elements of the parameter string, 
separated by commas, are: 

TT=«*ID Transaction terminal type. 

DB^aa TWo-character name of the data base 

to be accessed by ' the user. Only 
one data base can be associated with 
a user name. 

UA»n Contents of the user argument area in 

the communication block. n ranges 
from 0 through 16777215. Default Is 
zero. User area contencs can be ex¬ 
amined and changed by tasks. The 
appropriate initial value is site 
dependent. Bit 0 Is the default 
task recovery bit. 


A simple set of terminal network file directives 
follows: 

//DIAL. 

/AJOHNSN,TT=*IO,DB=8C, 

UA»16117711B. 

/BJOHNSN^TT=*IO,OB=BC, 

UA=00007700B. 

/XYZ1^TTs*ID,DB=8C. 


NETWORK FILE ORIGINATION 

When an error-free network description is ready, an 
analyst should create a system file called NCTFi 
(where 1 is the network file Identifier) from the 
terminal network description file. 

A typical way to originate an NCTFi file follows. 
First, the user establishes a set of network 
description statements as a local file. 

MCTF. 

USER/Username^password^famllynane. 

^ CHARGE/Chargenumber^projectnumber. or (*) 
COPYBR^INPUT^NET. 

SAVE^KET. 
end -0 f-record 

Network description statements 
end-of-f1Le 

Then the user enters the following at the system 
console. 

X.DIS. 

USER,username^passuord^f ami lyname. 
CHARGE,chargenumber,projectnumber. 

6ET,NET. 

SUI,377777. 

0EFINE,NCTF1/CT=PU. 

COPY,NET,NCTFi,V. 

RETURN,NCTFi,NET. 

This creates a direct access public file called NCTFI 
under the system user index 377777. NCTFi Is used to 
generate terminal status table entries. 

Figure 9-1 illustrates a terminal status table entry. 
Each line gives the user name and Its associated data 
base, read and update securities, and user area 
value. 

When a run unit originates from a terminal, the 
transaction executive uses the appropriate entry in 
the terminal status table to construct words 0 and 1 
of the communication block. 

After the network file is originated, it must be up¬ 
dated to reflect changes, and the transaction execu¬ 
tive must be reinitialized to recognize the new in¬ 
formation. 
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TERMINAL STATUS TABLE ENTRY 


oommunication line field 


59 55 53 42 36 24 17 11 0 



Word 1 

id Function 

A User active* 

L Terminal logged in* 

D Terminal down* 

C Connection requested from network or terminal off* 

R Recovery required* 

N Recoverable transaction run* 

ACN Application connection number. 

Word 2 

id Function 

M Multiple block input being sent* 

I Input wanted* 

F Last message block sent* 

P Connection to be postponed* 

C CDCS abort. 

NT Number of transactions received from terminal. 

Figure 9-1. Communication Between a Terminal Status Table and a Communication Block 
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TASK LIBRARY 
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A task library contains all of the named-transactions 
and tasks that may be requested by a user group with- 
in the transaction subsystem* The task library is 
created by the LIBTASK utility* 

A task library file is a direct access permanent 
file with no password that must be created with a 
DEFINE command before a library creation run 
occurs* However, it does not have to be attached by 
the user unless the DA option is specified (refer to 
LIBtASK command)* The transaction subsystem 
simultaneously supports one system task library and, 
optionally, one task library for each data base* 

The system task library, called TASKLIB by default, 
may be renamed at the site's option* It Is defined 
under the transaction subsyst^ user name and given 
write permission to that user name* The name 
TASKLIB may also be changed using the K display 
command K.TLF* (Refer to the NOS 2 Operator/Analyst 
Handbook*) 


A user task library must be named xxTASKL where xx 
is the name of the data base with which the library 
is associated* It must be defined under the data 
base user name, and explicit write permission must 
be granted to the transaction subsystem user name to 
access the file* 

During initialization, TAF attempts to attach a 
library for each Initialized data base* The xxJ 
file is accessed to determine the user name needed 
to attach the library. When a scheduling request is 
received, the transaction subsystem searches for the 
named-transaction or task first in the associated 
data base library, if one exists, and then in the 
system library* Transaction ' and task names, 
therefore, need be unique only within a given task 
library* The only exception to this procedure is 
the initial task, ITASK, which is always loaded from 
the system library* 


LIBTASK UTILITY 

The LIBTASK utility creates a new library, adds new 
named-transactIons and tasks to an existing library, 
deletes named-transactions and tasks from an 

existing library, replaces tasks in an existing 

library, and compacts an existing library by 
removing inactive records* Named-transactions and 

tasks may be added or deleted while the transaction 

subsystem is running, because tasks are added as a 

new file at the end of the library* The library is 

a multifile file* The transaction executive 

attempts to read a new library directory if the 

LIBTASK command contains the TT option* Thus, on¬ 
line update of any task library Is allowed* 


If the library is modified while the transaction 
subsystem is running and the user wants the new 
directory used, the user number and password of the 
LIBTASK user are passed to the transaction 
subsystem for validation* This is done by 

intercontrol point communication, which is also used 
to check if the transaction subsystem is running if 
the CR or PR option is selected* Therefore, the 
first USER command in the job must have permission 
to do intercontrol point communication* (Refer to 
the NOS 2 System Maintenance Reference Manual for 
Che use of MODVAL to alter permissions.) The 
LIBTASK run issues an error message and does not 
update the library If the validation fails. The 
task binaries to be added or replaced are in ABS or 
OVL format produced by the CYBER Loader* 


TASK RESIDENCY AND TYPE 

An important option of LIBTASK enables the user to 
specify the residency and type of tasks on the task 
library. A task can reside on central memory, 
extended memory, or mass storage* This can be 
specified with the C and E options on LIBTASK 
directives* 

A task can be of either reusable or nonreusable 
type* A reusable task must be written so that it is 
reinitializing* A reinitializing task (program) 
does not modify program areas that the program 
considers constant; if it does, it resets 
(reinitializes) these areas upon reentry. Multiple 
requests for a reusable task can be queued together; 
this is partly under the control of the person who 
sets up the task library and partly under the 
control of the transaction executive* The queuing 
of multiple requests occurs in an internal list, the 
requested task list (RTL). Each entry in this list 
represents a scheduling request for a copy of a 
task* There may be multiple entries in the RTL list 
for a given task* The LIBTASK queue limit input 
directive can be used to specify the maximum number 
of transactions that can be queued against one 
entry. When the transaction executive schedules a 
copy of a task from the RTL list, it picks an RTL 
entry and forces all of the multiple requests queued 
for that RTL entry to use the same copy of the task* 

It Is generally possible to have multiple copies of 
a given task in execution at the same time (note 
that this does not apply to CM-resident tasks). 
Additional application control of task scheduling is 
provided by the Q LIBTASK option in the input 
directives. 

A nonreusable task Is not a reinitializing task; a 
new copy of the task must be loaded from the task 
library for each transaction. 
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parameter 


The task type can be specified with the D option on 
LIB TASK directives. The queue limit can be 
specified with the QL option. 

If a task is specified as central memory-resident 
and reusable, it is loaded to a subcontrol point 
when TAP is initialized and, unless the task aborts, 
remains at that subcontrol point to service 
transactions as long as TAF is running. If the task 
aborts, another copy of it will be loaded. It is a 
single copy task. No additional copies of this task 
are loaded to process requests after queue limit has 
been reached. 


LIBTASK COMMAND 

The LIBTASK command has two formats. The first 
format allows specification of the file containing 
input directive statements; this format is: 

LIBTAS K (P')/P2/ • • • /Pn^ 

The second format specifies that input directive 
statements are included in this LIBTASK command. 
This format is: 

LIBTASK(pi,p 2, ...,Z, ...,pjj);di;d2; ;dji. 

; Unique delimiter that does not occur 

in any input directives. This 
delimiter does not have to be a 
semicolon• 

di Input directive statement (refer to 

Input Directives In this section). 

The Input directives on a LIBTASK command remain in 
effect for a task In an existing task library until 
the task is specified in a subsequent LIBTASK 
command; that is, the most recent input directives 
(Including default Input directives) for a task take 
precedence over earlier input directives. However, 
this is not true for a task that is not in a task 
library; in this case, the first input directives 
(including default input directives) take precedence. 

For example, you specify the following command: 

LlBTASK(p^^P2^P3^...^Pn);*T1 DL. 

This conmand logically deletes task TI. If you 
specify task Tl in a subsequent LIBTASK cocmand and 
do not specify DL, the task is activated (by 
default). 

The LIBTASK command cannot exceed 80 characters. 

The parameters (p^) for either format can be in 
any order and are: 

Parame ter Description 

I Specifies the file containing input 

directives. The file is not rewound 
before processing. All directives 
that do not refer to a task name 
present on the B file or P file are 
ignored. Options are: 

I File is COMPILE. 



Description 

I»lfn 

File is specified by 
you. 

I-O 

No directive file 

exists. 

Quitted 

Default file is INPUT. 

Specifies the file containing task 
binaries to be added to the library. 
These may be tasks already existing 
in the library or they may be new 
ones. The file is rewound before 
processing. Options are: 

B 

File is LGO. 

B-lfn 

File is specified by 
you. 

B-0 

No binary file exists. 

Omitted 

Default file is LGOB. 

Specifies the file on which output is 
written. Options are: 

L 

File is OUTPUT. 

L-lfn 

File is specified by 
you. 

L«0 

No output is written. 

Omitted 

Default file is OUTPUT. 


P Specifies the name of a direct access 


permanent file to be 

used as 

the 

library file. 
Options are: 

The file 

is required. 

P 

File is TASKLIB. 


P-lfn 

File is 
you. 

specified 

by 

P-0 

No old 
exists. 

library 

file 

Omitted 

Default 

TASKLIB. 

file 

is 


N Specifies a newly defined direct ac¬ 

cess permanent file to be written as 
the new library file. Use of this 
option eliminates the complete copy 
of the P file to a scratch file on 
the PR option, thus significantly 
reducing the purge time for long 
libraries. The P file is not purged. 
Options are: 

N File is TASKLIB. 

N«lfn File is specified by 
you. 

Omitted Default file Is the 
file specified by P. 
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Parameter 


Description 


Parameter 


Description 


IX) Produces a report of tasks and their 


attributes, 
attributes, 
tasks* It 

specify the 
if I-O and 
the format 
options are: 

named-transactions with 
and names of member 
is not necessary to 
TT option when using LO 
B»0* Figure lO-l shows 
of the report* The 

LO 

Same as L0»A* 

LO-A 

Report all tasks and 
transaetions* 

LO-T 

Report only tasks* 

L0»X 

Report only trans¬ 
actions * 

omitted 

No report is 

produced* 

Specifies Che name of a cask or 
transaction* This parameter is 

valid only when the LO parameter is 
also specified* If L0*T, TN names a 
cask; if L0»X, TN names a 

transaction* The options are: 

TN«tname 

The task or trans¬ 
action (tname) is 

the only one re¬ 
ported on* 

omitted 

All tasks or all 
transactions are re¬ 
ported on* 

Disables all 
the library 

attaches and returns of 
files in the LIBTASK 


program* With this option selected, 
the N file and the file specified by 
P must be attached prior to the 
LIBTASK call* If a library is 
attached in the proper mode from 
another user name, the DA option 
must be selected so that LIBTASK 
does not try to attach the 
appropriate libraries under the user 
name from which the update is being 
run* 

CR Creates a new task library* LIBTASK 

reads one task at a time from the B 
file, checks for an input directive 
for the task, constructs a directory 
entry, and Inserts the entry in 
alphabetical order in the library 
directory* The directory is written 
at the end of the library* This 
option applies only if LIBTASK was 
able to attach the task library 
(specified by the N option) in write 
mode. 


PR Removes inactive task binaries and 

old directories from the task 
library* LIBTASK processes the B 
file and the input directives norm¬ 
ally and, if N is not specified, 
copies the entire library to a 
scratch file* The current binary 
for each task in the library is then 
transferred from the scratch file to 
the library file, and the directory 
is updated and written at the end* 

Therefore, only one copy of each 
task and one directory remain in the 
library* If N is specified, no 
scratch file is written, and P is 
not purged* The new library file 
contains only the latest copy of 
each active task and one directory* 

This option applies only if LIBTASK 
was able to attach the task library 
(specified by the N option) in write 
mode* 

TT Instructs the transaction executive 

to update the TAF-resident copy of 
the task library directory while TAP 
is running* If not specified, TAF 
will not become aware of the update 
until the next time it is 

initialized* 

The Installation parameters TLl^N and 
TRIYIN are used to specify the amount 
of space to be reserved for adding 
tasks and transactions for each of 
the TAF-resident task library direc¬ 
tories* The default allows 10 addi¬ 
tions for each* Although further 
additions can be made to your task 
library, they will not be recognized 
by TAF until TAF is reinitialized. 
There is no limit to the number of 
times existing tasks can be replaced* 

The user name from which LIBTASK is 
being run must be the same as the 
user number in the xxJ file associ¬ 
ated with Che library being modified, 
and TAF must be able to attach the 
library in write mode in order for 
the update of TAF's copy of Che TLD 
to take place* You must be validated 
for intercontrol point communication 
(the CSTP bit in user's access word 
must be set) to use the TT option* 
Each time you use the TT parameter 
with the LIBTASK command, a file is 
added to your task library. 

Z Specifies that input directives are 

on Che LIBTASK command* This option 
overrides the I option* 
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Part 1. Task listing. Generated if LO"A or LO-T. 


TASK 

PRIORITY 


FIELD 

EXTRA 

ATTR 

NAME 

BEG MAX 

QL 

LENGTH 

FL 

DCEORQ 

task^ 

bp cnp 

qt 

fl 

efl 

attrib 

task2 

• 

bp mp 

qL 

fl 

efl 

attrib 

• 

task„ 

bp mp 

ql 

fl 

efl 

attrib 

task^ 

Task name* 





bp 

Beginning priority. 




mp 

Maximum priority. 




ql 

Queue limit* 





fl 

Field length 

required by the 

task. 


efl 

Extra field 

length 

the task may request* 


attrlb 

Task attribute list 

• The attribute Is in 

effect 


D Destructive code. 

C Central memory-resident. 

E Extended memory-resident. 

0 Task is OFF. 

R Solicited coomunicatlon block. 
Q Queueing enforced. 


Refer to Task Input Directives» 
later in this section, for infor¬ 
mation about these attributes. 


Part 2. Transaction listing. Generated if LO«A or LO«X. 




tnarne^ Transaction name. 

taskj^ Task names. If any task does not exist in this library, its name is enclosed in 
parentheses• 

data- The data managers used by the named-transaction. May be either or both: 
manager 

C Transaction uses CRM. 

D Transaction uses CDCS. 

Use of the indicated data manager is allowed if the letter appears, 
rc Recovery indicator. For recoverable transactions, RC appears in this position. 
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INPUT DIRECTIVES 

NAMED-TRANSACTION INPUT DIRECTIVE 

The named-transaction input directive is used to 
create and delete named-transactions. 

The format Is: 

/tname,Tl« task I ,T2» taskZ,T3« task3,T4» taskA, 

T5« tasks • RC»l]M»da tamanag er, DL. 

tname Transaction name. Must be one 

to seven alphanumeric characters. 

taski Name of the taskCs) in the named- 

transaction, tname. The tasks 
will be executed in the order 
listed. If a task issues a 
CALLTSK with CEASE, the remaining 
tasks in the original transaction 
will not be executed. 

RC Recovery indicator. When this 

parameter is specified, this 
transaction is recoverable. If 
not specified, this transaction 
is not recoverable. 

datamanager The data manager(s) that may be 
used by this named-transaction. 
If a recoverable transaction 
attempts to use CDCS or CRM and 
its usage was not declared via 
this parameter, the run unit will 
be aborted. This parameter is 
valid only if the RC parameter is 
also specified. The options are: 

C The transaction uses CRM. 

D The transaction uses 
CDCS. 

DL Causes the deletion of transac¬ 

tion tname from the task library. 
If specified, this parameter must 
be the only parameter in addition 
to the tname parameter on the 
dIrec tlve. 

Additional tasks can be made part of the execution 
of a named-transaction if they are initiated via a 
CALLRTN or CALLTSK with CEASE. A CALLTSK with 
CEASE, however, will prevent any remaining tasks in 
the original transaction from being executed. 

A task may be part of more than one named- 
transaction. 

Declaring the named-transaction recoverable is 
necessary but not sufficient to ensure correct 
recovery from failures. The transaction must also 
be constructed to support recovery as specified in 
section 7 of this manual. 

Tasks specified in this directive do not have to 
exist in the data base task library. This allows 
system tasks to be Included in the named-transaction 
definition. Named-transactions with tasks that do 
not exist in the data base task library are enclosed 
by parentheses in the report generated by using the 
LIBTASK LO parameter. 


Adding or deleting tasks within a named-transaction 
or altering other attributes is accomplished by 
respecifying the directive in full. 


TASK INPUT DIREaiVE 

To alter task characteristics, directive statements 
may be entered in the directive file. Only one 
statement should appear for each task. These 
characteristics are kept in the directory for use by 
the transaction executive when the task is to be 
executed. 

The directive statement format is: 

*name Pi,P2>•••»Pa* 

name is the task name and is any of the 

following input directives In any order. 

Directive Description 

BP»nn Beginning scheduling priority of 

task. 

BP Beginning priority defaults to 253 . 

BP omitted Beginning priority defaults to 20g. 

C Specifies a memory-resident task. 

The default is a disk-resident task. 

D Specifies a destructive code (non- 

reusable) task that is removed from 
the subcontrol point when the task 
is completed. The default is a 
reusable task. This option is 
recommended when debugging a task. 

DL Specifies that a task (name) is 

logically deleted. All logically 
deleted tasks are physically deleted 
from the task library when the 

LIBTASK command contains the PR 
option. 

E Specifies an extended memory- 

resident library copy of the task. 
The default is mass storage-resident, 

If tasks are specified as extended 

memory-resident, the transaction 
executive loads as many as will fit 
into its available extended memory 

during initialization and leaves the 
remaining tasks on the mass storage 
file. If no extended memory is 
available, all tasks are loaded from 
mass storage. 

If a LIBTASK command specifying the 
TT option is issued while the trans¬ 
action executive is running, no 
tasks are replaced or added to 
extended memory, and one of the 
following situations occurs. 

• Old copy of task In extended 
memory and new copy In 
extended memory. The new 
copy is Ignored, and the old 
copy remains on the library 
in extended memory. 
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Dlrec tive 


EF»efl 


IG 

MP»nii 

MP 

MP omitted 
0 

Q 


Description 


Dlrec tlve 


Description 


• Old copy not in extended 
memory and new copy In 
extended memory. The new 
copy Is used but Is read 
from mass storage. 


An active task Is a copy of a 
task which is both: 

• At a subcontrol point or 
rolled out. 


• Old copy In extended memory 
and new copy not In extended 
memory. The new copy Is 
loaded from mass storage. 

Specifies the maximum amount by 
which a task will be allowed to 
Increase Its Initial field length, 
efl Is assumed to be octal unless It 
contains an 8 or 9 or is followed by 
a trailing D. The default value is 
zero. EF will be Increased to the 
next multiple of lOOg if It is not 
already such a multiple. The maximum 
field length allowed for the task is 
(initial task FL) + efl. The value 
of efl can range from 0 to BOOOOOg. 

Specifies that a task (name) in the 
file specified with the B option Is 
ignored. 

Maxlmun scheduling priority of task 
(for future use in aging tasks). 

Maximum priority defaults to 30g. 

Maximum priority defaults to 40g. 

Sets task to OFF; requests for the 
task are routed to the OFFTASK 
routine (refer to OFFTASK in section 
11). The default Is OK. 

Specifies that queuing is to be 
forced, described as follows. This 
option alters the normal scheduling 
priority of the task (refer to 
Scheduling Priority) as follows: 

1. When there are no active copies 
of the task, the first copy of 
the task is scheduled as usual 
(refer to Scheduling Priority). 


• In the process of 
handling a transaction 
or has transactions 
queued against it (the 
copy). 

If a LIBTASK function specifying the 
TT parameter Is Issued while the 
transaction executive is running and 
an attempt is made to change the Q 
attribute of a task on a library in 
use by TAF, then the Q attribute 
change will not affect TAF schedul¬ 
ing until the executive is 

reinitialized. 

This parameter is not applicable to 

CM-resident tasks. 

QL^n Specifies the number of requests, up 

to a maximum of five, that can be 
queued for an RTL entry for a task. 
If a task uses a large amount of 
memory and executes rapidly, per¬ 

formance is not degraded if requests 
are queued. In this case, multiple 

copies of the task require too much 
memory. If a task does a large 

amount of I/O, then performance is 
degraded if requests are queued. In 
this case, multiple copies of the 

task enhance performance. 

QL Queue entry limit defaults to five. 

QL omitted Queue entry limit defaults to three. 

R Specifies that the FL assigned to a 

CM-resident task is to be reduced to 
the initial load value each time the 
transaction is run. The default is 
no reduce. Non-CM-resldent tasks 

are always started with their 

initial load value. 


2. While there are from one to six 
active copies of the task in 
TAF, another copy of the task is 
not scheduled until the number 
of transactions queued against 
its RTL entries equals or 
exceeds the queue limit 
specified by the QL directive. 
When an RTL entry is used to 
schedule a task, it is released 
and made available for 
requesting the scheduling of 
other tasks. 


SC Sets the task cotomunication block 

load status to solicited. This 
means you must request the 
communication block and supply a 
valid address (using the BEGIN 
request) after the task is initi¬ 
ated. The default is unsolicited. 


All directives for one task must appear on the same 
line. The following situation will result in only 
Pi being recognized as an Input directive for 
TASKl. 


3. When the number of active copies 
of the task equals seven, 
additional copies of the task 
will not be scheduled. This 
applies even if the queue limit 
is 1. 


*TASK1 pi. ' 

*TASK1 P2. 

• Improper way to specify 

. I input directives. 

*TASK1 Pn. > 
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SCHEDULING PRIORITY 

When the tasks are queued, the scheduler will attempt 
to load the task with the highest current priority. 
If there are several tasks with the highest priority, 
the task with the lowest field length requirement 
will be selected for loading. When a task enters the 
queue, the beginning priority (BP) is used as the 
task's current priority. The current priority is 
then aged (incremented by one) every second up to the 
maximum priority (MP). Tasks in the queue having 
identical current priorities and field length re¬ 
quirements normally will be scheduled in the order 
they entered the queue. 

With these directives, classes of tasks can be 
created. For example, if two classes were created 
(X and Y) their priorities could be: 

Xbp = 25$ Xhp = 408 

Ybp = 308 * *^8 

In this case, no tasks in X could be scheduled until 
all tasks in Y having a current priority greater than 
4'Og had been scheduled. 


CREATING A NEW TASK LIBRARY 

The following examples show how you can create a new 
task library, explanation is provided after each 
LIBTASK command. 

UBTASK(P«0, N-lfn 1 , CR,B-lfn 2 ,1) 

LIBTASK copies file lfn 2 to file Ifnj according 
to input directives in the COMPILE file and adds a 
new sorted task library directory at the end of file 
Ifni. 

LIBTASK( P*1 fn 2 , N-1 fn 1 ,2); *name 
PliP2*****Pn- 

LIBTASK copies file lfn 2 to file Ifni and adds a 
new sorted task library directory at the end of file 
Ifni according to input directives on the LIBTASK 
command. 

LIBTASK( P»1fn 2 ,N-lfni,PR,Z);*name 
Pl»P2»•••»Pn* 

LIBTASK copies all active (not logically deleted or 
replaced) task binaries from file lfn2 file 

Ifni ^ sorted task library directory 

at the end of file Ifni according to input 
directives on the LIBTASK command. 

LIBTASK(P»1fn2,N«1fni,B»lfn3,I) 

LIBTASK copies file lfn 2 to file Ifni, copies 
file lfn 3 to file Ifni according to input 
directives in the COMPILE file, and adds a new 
sorted task library directory at the end of file 
Ifni. 

LI BTASK( P» 1 fn 2, N»1 fn I, B=1 fn 3, PR, I) 

LIBTASK copies all active (not logically deleted or 
replaced) task binaries from file lfn 2 to file 
Ifni, copies file lfn 3 to file Ifni according 
to input directives in the COMPILE file, and adds a 
new sorted task library directory at the end of file 
Ifni* 


UPDATING AN EXISTING TASK LIBRARY 

The following examples show how you can update (add 
new tasks and delete and replace existing tasks) an 
existing task library without supplying any 
binaries. An explanation is provided after each 
LIBTASK command. 

LIBTASK(P“lfni,Z) ;*name ... 

LIBTASK adds a new sorted task library directory at 
the end of file Ifni according to input directives 
on the LIBTASK command. 

LIBTASK(P»1fn 1 ,PR,Z);*name pi,p 2 >•••»Pn• 

LIBTASK copies all active (not logically deleted or 
replaced) tasks from file Ifni onto a scratch 
file, copies the scratch file back onto file Ifni, 
and adds a new sorted task library directory to the 
end of file Ifni according to the input directive 
on the LIBTASK command. This command is not valid 
when TAF is up and has attached file Ifni. 

LIBTASK(P«1fn 1 ,B-lfn 2 ,Z);*name 
Pl»P2»•••»Pn• 

LIBTASK copies file lfn 2 to the end of file Ifni 
according to input directives on the LIBTASK 
statement. LIBTASK adds a new sorted task library 
directory to the end of file Ifni* 

LIBTASK( P«lf n 1 , B-lf 02 , PR, I-lf 03 ) 

LIBTASK copies all active (not logically deleted or 
replaced) tasks from file Ifni onto a scratch 
file, copies the scratch file back onto file Ifni, 
copies file lfn 2 to the end of file Ifni 
according to input directives on file lfn 3 , and 
adds a new sorted task library directory to the end 
of file Ifni* This command is not valid when TAF 
Is up and has attached file Ifni* 


DELETING A TASK FROM A TASK LIBRARY 

With the DL input directive on the LIBTASK command, 
you can logically . delete a task from the task 
library if TAF is up and has attached the task 
library as follows: 


LIBTASK(P«lfni,TT,Z);*name DL. 


In this example, LIBTASK logically deletes a task 
(name) from file Ifnj^. The TT option is required 
when TAF is up. The DL input directive is the only 
input directive allowed for the named task. 


With the PR option on the LIBTASK command, you can 
delete inactive tasks from the task library when TAF 
is not up and when TAF is up but has not attached 
the task library. 


LIBTASK(P»lfni,PR,Z);*name DL. 

In this example, LIBTASK physically deletes a task 
(name) from file Ifnj. TAF must not have the file 
attached when this command is executed. 
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IGNORING A TASK IN THE REPUCEMENT FILE 

With the IG input directive on the LIBTASK command, 
the user can tell LIBTASK to ignore a task binary in 
the replacement file specified with the B option as 
follows: 

LIBTASK(P«lfni,B»lfn 2 ,Z);*name IG. 


In this example, LIBTASK skips a binary cask (name) 
on file lfn 2 when copying file lfn 2 to file 
Ifnj. The IG input directive is the only input 
directive allowed for the named task. 
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The applications progrannner should be aware of the 
functions of these tasks but may omit the detailed 
infomation contained in this and section 12* 


Several system tasks are required with every 
application; BTBAN recovery task (BTASK) , data base 
recovery task (ClASK), Initial task (ITASK), 
K display director (KDIS), logout transaction 
teiminal (LOCT), message abort (MSABT), inactive 
task (OFFTASK), CDCS rerun task (RCTASK), run unit 
recovery task (RTASK), system message (SYSMSG), and 
execute named tasks (XTASK). Bach must reside on 
the system task library of every transaction 
system* Limited versions of these system tasks are 
supplied by Control Data; however, modifications to 
these tasks are often necessary for specific 
applications* One additional system task, CBMIASK, 
is required if the TAF/CRM Data (Onager is used. 
Refer to the TAF/CKM Data Manager 1 Reference Manual 
for Infoxmation on CRMTASK* 


Directions for installing these tasks are contained 
in the TAF Installation section of the NOS 2 Instal¬ 
lation Handbook* 


BTRAN RECOVERY TASK (BTASK) 

BTASK recovers rerunnable BTRAN run units* BTASK 
must be installed on the TAF system library* 


DATA BASE RECOVERY TASK (CTASK) 

CTASK helps TAF/CRM recover the data base during TAF 
initialization, terminal failure, and NETWORK 
failure. CTASK must be installed on the TAF system 
library. 


INITIAL TASK (ITASK) 

Tte primary functions of ITASK are analyzing 
terminal input and TAF-originated transactions* If 
the TAF-orlginated transaction field Is set in the 
communication block (figure 2-1), CTASK uses a table 
to Initiate the processing routine associated with 
that type of transaction* Otherwise, CTASK examines 
three characters, starting with the first character 
of the input message* The first of these three 
characters is the transaction code; the other tvx> 
comprise the sub transaction code entered from a 
terminal • 


ITASK recognizes the transaction code EX*, which is 
used to call the system transaction XTRAN* This 
special transaction code is reserved for XTRAN. 

rNoTTl 

Because ITASK schedules tasks, care 
must be taken to avoid entering an 
infinite loop when a task calls CTASK. 


ITASK is described in more detail in section 12. 


K DISPLAY TASK (KDiS) 

KDIS is a system task scheduled by the transaction 
executive when the K* SWITCH command is entered by 
the console operator* KDIS requests the K display 
and displays a complete list of K display commands* 
The K display commands are discussed in the NOS 2 
Analysis Handbook* 


LOGOUT TASK (LOOT) 

This task logs a terminal out of TAF* However, the 
task does not log the terminal off the computer 
system* The task sends a message, END OF 
TRANSACTION SESSION; performs a lOGT request; and 
performs a CEASE request* The terminal Is then 
available for login to TAF or other network 
applications* 


MESSAGE ABORT (MSABT) 

Message abort (MSABT) is a system task that sends 
error messages to the originating terminal when a 
transaction is terminated due to a system-detected 
error* MSABT checks for error codes that were 
placed in the communication block by the transaction 
executive or the initial task* When an error code 
is detected, MSABT sends the appropriate error 
message and initiates an abnormal CEASE function. 

MSABT is scheduled in the same manner as other tasks* 

If the TOTAL Data Manager is used, MSABT must be 
modified to perform a FREEX command. This ensures 
that TOTAL records are released if a task aborts. 

Error messages issued by MSABT are described in 
appendix B. 
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INACTIVE TASK (OFFTASK) 

This Cask is provided Co give you concrol over an 
incernal condicion chac aighc be che resale of 
operacional error. OFFTASK is scheduled by Che 
cransaccion execucive when a requesc has been 
received for an inaccive Cask. The cask oay be 
inaccive or off due Co Che use of Che K.OFFTASK 
command or use of a LIBTASK dlrecClve when Che Cask 
was placed in che library. OFFTASK sends an error 
message Co Che orlglnacing cerminal and ceases 
abnormally. Ic is expecCed chac you will expand che 
Cask Co handle any specific condiCions Chat may 
exisc when a Cransaccion is incerrupced by an 
inaccive Cask* 


CDCS RERUN TASK (RCTASK) 

Vfhen CDCS becomes available afcer a failure, RCTASK 
is accivaced. RCTASK decermines which cerminals 
were effecCed by Che CDCS failure and reruns cheir 
cransaccions (if rerunnable). 


RUN UNIT RECOVERY TASK (RTASK) 

The recovery Cask RTASK is a ConCrol DaCa-supplied 
recovery Cask chat will handle mosC cransaccion 
applicacion needs; however, some sices may wish Co 
modify RTASK Co handle special requiremencs• The 
following discussion will aid underscanding of RTASK 
in case a modificaCion is required. RTASK muse be 
available Co all applicacions. This implies chac 1C 
muse be presenc on che TAF syscea Cask library 
(TASKLIB) or en all of Che daCa base Cask libraries. 
It may be on the TASKLIB and any number of selecced 
daCa base cask libraries. In this case, only chose 
applicacions wichouc cheir own copy of RTASK will 
use che version on TASKLIB. 

Afcer Cerminal disconneecs, or NAM, TAF, and sysCem 
failures, Che Cerminal musC go Chrough Che login 
procedures wich TAF. The following sceps oucline 
Che decision process followed by RTASK* Uhen a true 
condition is encouncered, Che remaining steps are 
skipped. 

1. If Che run unit is not recoverable because 
RC was not specified on the LIBTASK direcClve 
for che named-transaction, RTASK sends the 
message READY to the terminal. 

2. If the run unit is not rerunnable because of 
an I/O error encountered by TAFREC, RTASK 
Cells che terminal operator recovery has 
occurred and Co enter che next command. 

3* If che run unit is secure and the data base 
is committed, RTASK sends Che Cerminal 
confirmacion (SECURE) message. 

4, RTASK tells the Cerminal operator that 
recovery has occurred, chat the transaction 
is being rerun, and reruns the Cransaccion. 


SEND MESSAGE TASK (STASK) 

This cask sends a message to Che cerminal and Chen 
terminates. STASK is called from ITASK only when 
ITASK is Co terminate after sending a message Co Che 
terminal. 


SYSTEM MESSAGE TASK (SYSMSG) 

This Cask sends K.MESSAGS-enCered messages and 
K display diagnostic messages Co Cerminals. It 
calls Che subroutine in COMKCBT passing Che user 
argument bits. The word returned is sent after Che 
message is sent* 


EXECUTE NAMED TASK (XTASK) 

The execute named cask (XTASK) is a special Cask 
scheduler used Co execute most named tasks. It will 
not execute Casks by Che names XTASK, KDIS, MSABT, 
OFFTASK, SYSMSG, and XTASK. These are Che names of 
required system Casks. XTASK can be used Co 
schedule L06T as a means of logging a Cerminal out 
of transaction mode. XTASK is initiated via system 
transaction XTRAN, described following Che XTASK 
description. 

EX.task 

EX* Special three-character transaction 
code which causes ITASK to schedule 
XTRAN via a CALLTRN request. XTRAN 
specifies XTASK as its only task. 


Cask One- Co seven-character alphanumeric 
task name, left-justified (no space 
between EX. and task) with a 
nonalphanumeric character terminator. 

A site may want to delete the TRANS Cable entry of 
STRAN (X.), XTASK in the TRANT table of ITASK, or 
the system Cask XTASK altogether for security 
reasons. XTASK was provided as a means of 
scheduling casks, and as an example of how a site 
might use such a Cask. However, it may provide too 
much flexibility, and therefore should be used with 
discretion* 


XTRAN TRANSACTION 

Transaction XTRAN must be defined when che system 
Cask library Is created. XTRAN will be scheduled 
when che three-character code EX. is entered from a 
Cerminal* This transaction allows scheduling any 
Cask in che local or system Cask library as 
described under XTASK. 

The characteristics of XTRAN are: 

• Task name Is XTASK* 

• No data managers. 

• Not recoverable. 
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This section describes some of the features, 
options, and requirements of ITASK* 

MACROS 

ITASK contains three tables. These tables are set 
up for the following codes* 

• Time a task Is to be run 

• Transaction code 

• Subtransaction code 

A macro is used to set each type of ITASK table* 
These three COMPASS macros, TIMCNT, TRAN, and STRAN, 
are discussed here* 


TIMCNT MACRO 

The TIMCNT macro makes an entry In the table of 
time-originating tasks (TTOT)* TTOT contains the 
time a transaction or task is to be initiated and an 
address• 


One TTOT contains all of the entries, regardless of 
the application that Is to use them* This feature 
allows tasks to be rxm at predetermined times 
without specific task requests or terminal input to 
initiate the run* 

The format is: 


TIMCNT hr,min,sec,address 


hr 

Hour* 

min 

Minute* 

sec 

Second * 

address 

Routine address 

TTOT table 

format is: 


Word 1 TTOT, number of entries in the 

table* 

Word 2 

and following Table entries* 

The format of a TTOT entry is shown in figure 12-1. 


TRAN MACRO 

The TRAN macro sets up entries for the table of 
transaction codes (TRANT)* TRANT contains the 
address of the table of subtransaction codes for 
that particular transaction code* ITASK assumes 
that the TRANT table is set up in 6-blt display code 
order* It uses the 6-bit display code value of the 
transaction code you enter to locate the proper 
entry in TRANT* 

The format is: 

TRAN code 

code One-character transaction code. 

The format of an entry In TRANT is shown in figure 

12 - 2 . 


STRAN MACRO 

The STRAN macro makes entries in the table of 
subtransaction codes (TRANS). TRANS contains the 
sub transaction code and the corresponding 
transaction name* 

The format is: 

STRAN sc,tname 

sc IWo-charac ter sub transact ion code* 

tname Name of the transaction to be called* 

The format of an entry in TRANS is shown in figure 
12-3. 


59 41 17 11 5 0 


addren 


hr 

min 

sec 1 







address Address is the tag of a user-written subroutine that is called by ITASK to set up 

and call the desired transaction or task* 

ITASK then clears the table entry so the request is not repeated* 
hrmlnsec Time the transaction or task is to be initiated in hours, minutes, and seconds* 


Figure 12-1. Format of a TTOT Table Entry 
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59 

53 

17 0 



length 

0 

address 


length 

Length of subtransaction code table (In format allowing unpack function to 
retrieve it). 

address 

Address of section In subtransaction table containing associated entries* 


Figure 12-2. Format of a TRANT Table Entry 

,-—— ---, 


59_47_41_ 0 


sc 


0 


tnaiTM 


sc Subtransaction code* 

tname Transaction name, left-justified, zero-filled* 


Figure 12-3* Format of a TRANS Table Entry 


Each group of entries relating to the same trans¬ 
action Is placed Immediately following the TRANT 
entry for that code, although the subtransaction 


table is assembled 
the TRANT and TRANS 

elsewhere* 
tables• 

This 

is 

an example of 

TRANT 

BSS 

0 





TRAN 

A 





STRAN 

OE^TRNANE 





STRAN 

03^TRANN 




A is the 

transaction code. 

02 

and 

03 are the 


sub transaction codes, and TRNAME and TRANN are the 
respective transactions to be requested. 

A site may want to delete the TRANS table entry of 
STRAN (X*), XTASK In ITASK for security reasons. 
XTASK is described In more detail in section 11* 


ITASK DESCRIPTION 

Entries in all ITASK tables, as well as the user 
subroutines for TIMCNT entries In TTOT, should be 
Inserted In the designated places within the program 
before assembly* TRANT and TRANS entries must be In 
alphabetical or numerical order according to 6-blt 
display codes* 

Initial terminal input, while TAP is running 
normally, results in execution of a transaction as 
follows: 

• If the first three characters of input are 
recognized by ITASK as a transaction code 
that Is associated with a transaction, then 
ITASK attempts to schedule the transaction. 
Transaction codes can be associated with 
transaction units through the STRAN macro, 
previously described* 


• If no transaction was associated with the 
transaction code, then ITASK Interprets the 
string of characters starting with the first 
character Input and terminating with the 
first nonalphanumerlc character as a 
transaction name* If this string Is null or 
more than seven characters long, an error 
message Is Issued; otherwise, ITASK will 
attempt to schedule the named-transaction* 
If the named-transaction does not exist in 
the task library corresponding to the 
terminal application or in the system task 
library, an error message Is Issued via 
MSABT* 

Initial terminal Input while TAF is idling down 
(following an IDLE,TAF or K.IDLE command) is 
processed as follows; 

• If the input Is EX.LOGT, the logout is 
processed normally* 

• If the input is anything else, ITASK issues 
the message TAF IDLING DOWN to the terminal 
and ceases without trying to schedule the 
requested transaction* 


TTOT entries must be accompanied by user-written 
subroutines to set up and call the task, as follows: 

• The system time Is retrieved from the 

appropriate word In the communication 
block* TTOT is then searched for any 
entries that were to be run by that time. 

• If such an entry is found, ITASK jumps to 

the user's subroutine to set up and call the 
task* This subroutine must set up the 
communication block required by the task 
that Is to be run. It must perform a 

CALLTSK without the cease option set to 

ensure that control is returned to ITASK. 
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TAF-ORIGiNATED TRANSACTIONS 

TAF recognizes certain conditions not normally noted 
or processed by user applications • Some of these 
conditions are: 

• Exceeding a length of time as specified by 
an assembly option (TACTL)* 

• K.IDLE command telling the transaction 
subsystem to idle down. 

• Transaction executive recovery. 

• Terminal login. 

• Network and terminal failures. 

When any of these conditions occurs, a TAF- 
originated transaction may be processed. Code In 
common deck COMKSTC identifies the condition. ITASK 
examines the communication block (figure 12-4) to 
determine the condition and jumps to a subroutine 
which sets up and calls the proper task or sequence 
of tasks to respond properly to the Identified 
condition. Although the Control Data-supplied ITASK 
contains code to process each of the conditions» 
sites may want to modify ITASK and provide 
transactions to suit their Individual needs. 

To provide TAF-origInated tasks that properly 
respond to the NAM conditions, the analyst should 
refer to the NAM/CCP 1 Reference Manual. 

A number of common decks aid in processing the 
TAF-origInated transactions as follows: 

• COMKSTC gives the values for the condition 
field of the communication block. 

• COMKNWF describes the fields for the NAM 
message word of the communication block. 

e COMSNCD gives values to fields In the NAM 
message word* 


CONDITIONS REQUIRING TAF-ORIGINATED TRANSACTIONS 

The conditions that require TAF-originated 
transactions and possible methods of processing are 
described here. Limited versions of routines needed 
to process these transactions are available in 
ITASK. To change the existing routines, ITASK must 
be modified to include the necessary code or call 
the necessary tasks. It may be advisable to include 
short procedures as subroutines in ITASK, but long 
or frequently updated transactions should be 
maintained as separate programs apart from ITASK and 
merely called from the ITASK subroutine. The 
recovery situations described in this subsection 
apply to sites not using TAF automatic recovery. 


Time Activation 

This might be processed by ITASK as follows; 

1. ITASK retrieves the system time from the 
appropriate word in the communication block. 

2. ITASK then searches the TTOT for any 

transactions that are to be run at that time. 


3. If such an entry is found, ITASK jumps to 
the user-supplied subroutine that must set 
up and call the next task for that 
transaction* This subroutine must set up 
the communication block required by the task 
chat is to be run. 


K.1DLE Console Operolor Command 

Same as IDLE,TAF command. Refer to ITASK 
Description earlier in this section. 
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Terminol Login 

The application may want to prompt the terminal 
user, set application character type, or go through 
recovery procedures if the user has the recovery 
field set in the user area of the terminal status 
table. Upon terminal login, the NAM message word of 
the communication block (figure 12-4) contains the 
following information: 


Bits 

Significance 

35-25 

Block size of terminal* 

24 

Signifies a hardwired terminal 
set * 

23-16 

Terminal class. 

15-8 

Page width of terminal. 

7-0 

Page length of terminal* 


Terminal Break Conditions 

If some tasks perform SENDs without the recall flag 
set, breaks can occur because of the following. 

• User break keys. 

• Output device not ready* 

• Incorrectly formatted data. 

For a user to resume processing after a terminal 
break, the following must occur* 

I. Terminal communication with NAM must be 
reestablished. When the break occurs, NAM 
places the supervisory message associated 
with the break In the NAM message word of 
the communication block. To restart 
terminal communications, TAF must send a 
reset supervisory message to NAM* The 
individual application need not provide this 
function. Upon the user task SEND request, 
TAF issues the reset supervisory message 
prior to honoring the SEND. 


2. The user must restme interaction with the 
application. The user application must 
provide this break recovery. The following 
description suggests one method. 


ITASK and any recovery tasks can communicate 
through the terminal status table user 
area. For Instance, when ITASK initiates a 
transaction, it could set a series of fields 
in the TST to indicate Important events in 
the transaction. The recovery task could 
examine the fields to determine what events 
had occurred. Nonrecovery tasks could watch 
a recovery field in the TST and CEASE to 
allow the recovery task to proceed ir a 
quiet environment. (TAF sets the recovery 
field in the TST before calling ITASK.) 


Terminal Connection Broken 

A connection may be broken because a line has been 
disconnected. If a SEND with recall was active, the 
task issuing the SEND rather than ITASK is notified 
of the error. It may be desirable for the applica¬ 
tion to process these incomplete transactions. TAF 
sets the recovery field in the terminal status table 
user area. The application can save terminal output 
on a data manager file and send it when the user 
logs in again. The outstanding block limit speci¬ 
fied in the local configuration file detemines how 
many messages must be saved, (Refer to the Network 
Products NAM 1 Network Definition Language Reference 
Manual.) 


Network Normal Shutdown 

TAF monitors task activity on communication blocks 
generated by terminal input* When all tasks have 
been completed and no tasks are performing WAITINP 
requests, TAF sends end connection supervisory 
messages to NAM for each logged-ln user and performs 
a NETOFF to end processing with the network. To 
initiate this condition, it may be desirable for 
ITASK to notify users of the pending shutdown and 
begin rejecting new transactions. 


Network Failure 

TAF sets the recovery field in the user area of the 
terminal status table for all logged-in users. All 
tasks performing WAITINP requests are scheduled* 
The application, through ITASK, may want to begin 
data base recovery. 


Network Immediate Shutdown 

TAF performs a NETOFF and sets the recovery field in 
the user area of the terminal status table. The 
application may want to begin recovery by processing 
only transactions from batch input. 


Terminal Inactive 

NAM issues a terminal inactive supervisory message 
when it detects that 10 minutes have elapsed without 

message traffic over a connection. TAF passes the 

transaction sequence nunber of any running, task 
using that user name to ITASK* The application may 

want to log out the user after a period of time to 

reduce line connect costs* 


Logical Error 

One of the application's tasks may have set up an 
application block header or message block 
incorrectly* If the task performed a SEND request 
with recall set, the task, rather than ITASK, is 
notified of the error. 
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Block Not Delivered 

This occurs because of a sysceo error. If Che cask 
performed a SEND requesc vlch recall sec, Che cask, 
racher chaa XTASK, Is aoclfied of Che error. Before 
scheduling ITASK, TAF secs Che recovery field in Che 
user area of Che tST, Ic may be desirable for che 
applicacion Co recover by sending Che lose block* 
The applicacion block number of Che block chac was 
lose is recurned in che NAM message word of Che 
communicaCion block* Tasks may specify a block 
number on che SEND or obcain che block number used 
by TAF* Resending Che lose block may cause Che 
block CO be delivered ouC of sequence, if furcher 
blocks had been senc following che lose block* 


Terminal Charocteristk Chonge 

A NAM Cerminal characCerisCic supervisory message is 
senC Co ITASK when Che cerminal operacor has 
redefined Che Cerminal class, page widch, or page 
lengch* 


Terminal Input Too txirge 

The Cerminal operacor senC a message longer chan che 
maximum inpuC message size* TAF will noC have 
journalized che input* 

I 


TERMINAL TYPE AHEAD 

The network allows terminal operator type-ahead* In 
other words, the terminal operator can enter several 
transactions without waiting for the response from 
the first* The network ignores all type-ahead when 
the terminal operator enters a user break I or user 
break 2* 


USER STATUS 

The network allows a terminal user to make a status 
requesc by typing: 

ct (alpha)® 

ct The network control character* 

(alpha) Any alphabetic character* 

TAF will right justify the character in word 3 of 
the communication block and initiate ITASK* At this 
point a user-written routine in ITASK must take over 
to perform whatever action is desired* The ITASK 
reason code will indicate a user status message* 
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CHARACTER SETS 


Table A-1 liats the character codes for the ASCII site analyst to see which character set is being 

63/64-character sets* Users should check with a used. 

Table A-1. 7-Bit ASCII Code Standard Print 63/64-Character Set (Sheet 1 of 2) 









7-Bit ASCII Code 

6-Bit 

Display Code 
(Octal) 

ASCII 

Character 

Octal 

Hexadecimal 

• 

072 

3A 

oot 

A 

101 

41 

01 

B 

102 

42 

02 

C 

103 

43 

03 

D 

104 

44 

04 

E 

105 

45 

05 

F 

106 

46 

06 

G 

107 

47 

07 

H 

110 

48 

10 

I 

111 

49 

11 

J 

112 

4A 

12 

K 

113 

4B 

13 

L 

114 

4C 

14 

M 

115 

4D 

15 

N 

116 

4E 

16 

0 

117 

4F 

17 

P 

120 

50 

20 

Q 

121 

51 

21 

R 

122 

52 

22 

S 

123 

53 

23 

T 

124 

54 

24 

U 

125 

55 

25 

V 

126 

56 

26 

w 

127 

57 

27 

X 

130 

58 

30 

Y 

131 

59 

31 

Z 

132 

5A 

32 

0 

060 

30 

33 

1 

061 

31 

34 

2 

062 

32 

35 

3 

063 

33 

36 

4 

064 

34 

37 

5 

065 

35 

40 

6 

066 

36 

41 

7 

067 

37 

42 

8 

070 

38 

43 

9 

071 

39 

44 

+ 

053 

2B 

45 

- 

055 

2D 

46 

* 

052 

2A 

47 

/ 

057 

2F 

50 

( 

050 

28 

51 

) 

051 

29 

52 

$ 

044 

24 

53 

B 

075 

3D 

54 


t In the 63/64-character set, this 6-bit display code represents 
a null character. Also, use of the colon in program and data 
files nay cause problems. This is particularly true when it 
is used in print and format statements. 
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Table A-1. 7-B±t ASCII Code Standard Print 63/64-Character Set (Sheet 2 of 2) 


ASCII 

Character 

7-Bit 

ASCII Code 

6-Blt 

Display Code 
(Octal) 

Octal 

Hexadecimal 

(space) 

040 

20 

55 

s 

054 

2C 

56 

• 

056 

2E 

57 


043 

23 

60 

( 

133 

5B 

61 

] 

135 

5D 

62 

X 

045 

25 

63t 

If 

042 

22 

64 

- 

137 tt 

5F 

65 

! 

041 

21 

66 

& 

046 

26 

67 

* 

047 

27 

70 

? 

077 

3F 

71 

< 

074 

3C 

72 

> 

076 

3E 

73 

(? 

100 

40 

74 

\ 

134 

5C 

75 

** 

136 

5E 

76 


073 

3B 

77 


tin the 63/64-character set, this 6-blt display code repre¬ 
sents a colon (:), 7-bit ASCII code 072, 7-bit hexadecimal 
code 3A* 

ttOn TTY models having no underline, the back arrow ) takes 
its place* 
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DIAGNOSTIC MESSAGES 


B 


This appendix contains an alphabetical listing of 
messages which may be important to the TAF 
programmer* Each message is followed by an 
explanation of the message and/or the circumstances 
causing it to be issued, the reconmended action, and 
the routine which issued the message* 


Lowercase letters are used within a message to 
identify variable fields* All messages beginning 
with lowercase (variable) fields are listed 
alphabetically according to the first nonvariable 
field after the messages that begin with nonvariable 
fields. 
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MESSAGE 

cmd ACCEPTED., 

AFTER IMAGE ACCUMULATOR TABLE OVERFLOW. 

AFTER IMAGE RECOVERT FILE IS FULL, 

db AFTER IMAGE RECOVERY FILES UNAVAILABLE. 


AIP DEBUG OPTION TURNED OFF. 

AIP DEBUG OPTION TURNED ON. 

AIP TOO LARGE FOR LOADING. 

filename ALLOCATED. 

APPLICATION ERROR - NO TERMINAL OUTPUT. 

APPLICATION FAILED applnam 

APPLICATION NETTED OFF - applnam 
APPLICATION NETTED ON - applnam 
ARF BLOCK SIZE IS LARGER THAN BUFFER. 

ARF DUMP TAPE HEADER ERROR. 

ARF ENTRY TABLE OVERFLOW 

ARF FILE HEADER ERROR. 

ARF HEADER ERROR. 

ARF HEADER STATUS (3) POSSIBLE ERROR. 

ARF ORDINAL MUST BE 01 OR 02. 

ARITHMETIC OR OTHER SOFTWARE ERROR IN TASK. 

ATTACH ERROR ON - filename. 


SIGNIFICANCE 

ACTION 

The network has accepted your terminal 
definition command cmd. 

None. 

When updating a file, the after image 
accumulation table was filled. 

The size of the AAIT 
table in OMPEC must be 
increased. Inform the 
data administrator. 

The active after image recovery file used 
by TAF is full. 

This file must be dumped 
by DMREC. 

TAF/CRM data manager tried to bring up an 
after image recovery file for data base db 
but failed. Possible reasons for the 
failure: 

- ATTACH error 

- ARF header name is incorrect 

- ARF header status error 

- CIO error on ARF 

- Change in ARF block length 

- ARF full 

If the data base was down previously, it 
will remain down. If not down, it will now 
be idling down. 

Correct problem with 
ARFs. 

Self^explanatory. 

None. 

Informative message. All network messages 
will be placed on trace file ZZZZZDN. 

None, 

A fatal error occurred causing TAF to abort. 

Inform site analyst. 

TWFA must be increased 
in deck COMKTAF. 

Informative message. 

None. 

A task error. A transaction has run without 
either an error message or a SEND being 
sent to the originating terminal. 

Correct task or inform 
data base administrator. 

An application has stopped without making a 
request to NAM to terminate. 

Restart application 
and/or contact central 
software support, 
analyst. 

Application applnam has requested 
termination of network access. 

None. 

An application has successfully requested 
and attained network access. 

None. 

The maximum block length field in the 
header record for an ARF is larger than the 
maximum block length (Installation 
parameter) allocated by TAF/CRM data 
manager. 

The file must be dumped 
using DMREC and 
preallocated. 

No header found on ARF tape. 

Use alternate tape if 
available. 

Too many recoverable file names exist on 
this ARF. 

Increase the size of the 
TL06 table with 
installation parameter 
TLOGL. 

No header was found on the ARF file. 

Down the data base, dump 
the data base, purge the 
old ARF, and create a 
new one. 

No ARF header on what is supposed to be an 
ARF. 

Check ARF for validity, 
inform data 
administrator. 

ARF header status shows a possible error 
condition. 

Inform data 
administrator. 

ARFs can have only 01 or 02 as an ordinal. 

Correct directive name 
(^RF/BRF). 

A task error. Hardware or the system 
detected a software error in the task. 

Correct task or inform 
data base administrator. 

The transaction executive cannot attach the 
file filename under present conditions. 

This usually implies that the file does not 
exist or modify permission has not been 

Correct error and 
reinitialize executive, 
or inform the data 
administrator. 


given to the TAF user name. 


ROUTINE 

CCP 

DMREC 

CAAI) 

TAF 

A AM I 


TAF 

TAF 

TAF 

DMREC 

MSABT 

NVF 

NVF 

NVF 

TAF 

DMREC 

AAMI 

DMREC 

DMREC 

DMREC 

DMREC 

MSABT 

TAF 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


ATTACH ERROR ON PF xxxxxxx. 

When attempting to attach a permanent file 
XXXXXXX/ an error was encountered. 

Check for valid 
directive file name and 
presence of a direct 
access permanent file by 
that name. 

DMREC 

ATTACH MODE MUST BE V, M, R/ OR RM. 

The mode parameter on the CYBER 

Record Manager CCHM) statement 
must be one of the specified values. 

Correct the mode 
parameter on the CRM 
statement or inform the 
data administrator. 

TAF 

n.nnn AVERAGE ACTIVE SUBCONTROL POINTS, 

n.nnn is the average number of simul¬ 
taneously active subcontroL points when 

TAF is not rolled out. An active 
subcontrol point is one which is in 
recall/ is waiting to use the CPU/ or is 
currently assigned the CPU. The 
sampling rate is once per second. 

None. 

TAF 

n.nnn AVERAGE OUTSTANDING CDCS REQUESTS. 

n.nnn is the average number of out¬ 
standing (uncompleted) systemThentrol 
t requests per second, r se 

The sampling rate is once per second. 

None. 

TAF 

BACKUP DIRECTORY - xxxxxxx HAS BEEN 
RECONSTRUCTED. 

No directory file for the specified data 
base. A new directory was generated from 
the information on the xxJ file. 

Inform data 
administrator. 

DMREC 

BATCH CONCURRENCY DISABLED. 

TAF was brought up without BATCH 
concurrency enabled. CTBC0N=Q). 

Ask data administrator 
to bring up TAF with 

BATCH concurrency 

ENABLED. 

BA AML 

BATCH RECOVERY ACTIVE ON DATA BASE 

Self-explanatory 

Wait for the completion 
of batch recovery/ then 
reinitialize the 
transaction subsystem. 

TAF1 

BEGIN CRM TASK RECOVERY. 

TAF/CRM has received a recovery indication 
from TAF. 

None. 

AAMI 

BFL = xxxxxxxB, MINIMUM REQUIRED « zzzzzzzB. 

Information on the actual value of the 
beginning field length and the minimum 
value TAF/CRM requires for the Common 

Memory Manager Buffer. 

None. 

AAMI 

BINARY RECORD WAS LESS THAN 64D WORDS LONG. 

The task binary file contains records in 
the wrong format. 

Ensure that a LOAD was 
performed after 
compilation of the tasks. 

LIBTASK 

BINARY RECORD WAS NEITHER ABSOLUTE NOR 

OVERLAY FORMAT. 

The task binary file contains records in 
the wrong format. 

Ensure that a LOAD was 
performed after 
compilation of the tasks. 

LIBTASK 

BLOCK BUFFER OVERFLOW. 

When attempting a record load operation/ 
the data block buffer was found to be too 
small. 

Increase the length 
of the working buffer 

WBUF. Inform the data 
administrator. 

DMREC 

BLOCK BUFFER TOO SMALL. 

Tape block on ARF was too large for buffer. 

Increase size of buffer 
and try again. 

DMREC 

BLOCK LOAD ERROR. 

Block load of a file failed because no 
header was found on dump tape. Or/ the 
targeted file or the tape does not match 
request file name. 

Load from previous dump 
tape. 

DMREC 

BLOCKAGE AMONG CM RESIDENT TASKS. 

The SU9 of initial field lengths for the CM 
resident tasks exceeds the minimum size of 
total task area. 

Correct error. 

TAF 

BOTH AFTER IMAGE FILES ACTIVE. 

Both after image recovery files for a data 
base are active. The after image files 
oust be dumped by DMREC/ if not already 
dumped. 

Dump the after image 
recovery files. 

TAF 

6RF PARAMETER TOO LARGE OR INVALID. 

The parameter on the 8RF statement is 
nonnumeriC/ the value is greater than the 
installation parameter BMAX, or too many 
parameters were specified- 

Correct BRF statement or 
reassemble TAF and 
related decks with a 
larger value for 8MAX 
(if possible). 

TAF 

BTASK - TAF AUTOMATIC RECOVERY NOT 

INSTALLED. 

A keyword specified in a TSTAT request 
requires TAF automatic recovery to be 
installed. 

Inform the data 
administrator. 

BTASK 

BTASK - TASK LOGICAL ERROR. 

An unexpected error status was returned. 

Inform the data 
administrator. 

BTASK 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


BTASK - xxxxxxx TRANSACTION NOT RUNNABLE 
NOW. 

BTASK - USER NOT DEFINED IN NETWORK FILE. 

C. B. NOT AVAILABLE TO SCHEDULE CTASK. 

CALLRTN NESTED CALL LIMH EXCEEDED. 

CANNOT DEFINE REFORMATTED FILE - filename. 

CDCS ABORTED PLEASE WAIT. 

CDCS CONNECTION ESTABLISHED. 

CDCS INVOKE FAILURE. 

CDCS NOT AVAILABLE. 

CDCS REQUESTED ABORT. 

CHANGED TLD DETECTED - filename, username. 

CIO ERROR ON RECOVERY FILE 

*CMM* ERROR. 

CMMBFL IS NOT LARGE ENOUGH. 

CONFLICTING LIBTASK OPTIONS - p1,p2. 


CONTROL CARD ARGUMENT ERRORS. 

CRF HEADER ERROR - filename. 


This occurs when an I/O error is detected 
and the data base cannot be recovered for 
the user xxxxxxx. 

Inform the data 
administrator. 

BTASK 

The user is not defined in the NETWORK file 
on a TSTAT request. 

Inform the data 
administrator. 

BTASK 

Communication block not available to 
schedule CTASK. 

Increase the number of 
communication blocks at 
initialization time 
using the K.MCB- command. 

TAF 

A task error. An attempt was made to nest 
CALLRTN requests more than 16 levels. 

Correct task or inform 
data base administrator. 

MSABT 

A reformat of the TAF COMMUNICATIONS 
recovery file was necessary, but when 
attempting to DEFINE the reformatted file 
CZZCRFAi), an error occurred. 

Purge the existing file 
indicated by filename. 

TAFREC 

A TAF transaction was using CDCS while CDCS 
aborted. The transaction will be rerun 
after CDCS comes back up. 

Operator can log off by 
typing in EX.LOGT, or 
wait for CDCS. 

ITASK 

Informative message. The connection 
between TAF and CDCS has been established. 

None. 

TAF 

CDCS files are not available. 

Inform site analyst or 
data administrator. The 
transaction should be 
rerun after the problem 
is fixed. 

MSABT 

Your TAF transaction attempted to use CDCS 
when it was not present in the system, CDCS 
aborted while your transaction was waiting 
for completion of a CDCS request CSSC), or 
CDCS aborted while your transaction was 
rolled out. 

Inform data 
administrator. 

MSABT 

TAF aborted the TAF transaction as a result 
of a request by CDCS. The detailed error 
message returned by CDCS is available in 
the JOURO file and will be sent to the 
terminal. 

Inform data 
administrator. 

MSABT 

An unrecognizable library directory format 
was encountered during a library directory 
update attempt. 

Inform site analyst. 

TAF 

A CIO error was encountered while trying to 
position the ARF or BRF correctly. 

Reinitialize the 
transaction subsystem or 
inform the site analyst. 

TAF1 

A *CMM* error occurred. Memory cannot be 
granted to load *0PEN* routine. 

Inform data base 
administrator. 

AAMl 

The size of the beginning field length 
(BFL) for the Common Memory Manager Buffer 
is not large enough to contain CMMTFL 
and CMMCAP and the user's Fn*S and 

FSTT-S. 

Data base administrator 
can either 

1> increase the size of 
CMMBFL, or 

2) decrease the size of 
CMMTFL, or 

3) decrease the size of 
CMMCAP. 

TAF 

The user specified an incorrect combination 
of LIBTASK command options. Possible 
incorrect combinations of pi and p2 are: 

- CR,PR 

- CR,n 

- PR,n 

- TT,N 

Another possible incorrect combination 
gives P«0,-N for p1,p2. This means that 
the user specified P=0 but did not specify 

N. 

The user must choose 
either pi or p2. For 
the P«0,-N combination, 
the user must specify N 
if no old task library 
(P«0) exists. 

LIBTASK 

User specified TT option when task 
library was not attached by TAF. 



Errors exist in the parameters on the 

LIBTASK command. 

Correct and rerun. 

LIBTASK 

I/O errors or logical errors were 
encountered in the header record of the 
named CRF. The file is unusable, 
filename File name 

Initialize the file 
using the K.INT initial 

K display command. 

TAFREC 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


CRF RECOVERY/INITIAUZATION ABORTED, 

CRF RECOVERY/INITIALIZATION COMPLETE 
CRF RECOVERY UNIT ERROR - fUenarae. 


CRM<...paratneter-l1st *..) 

CRM DATA MANAGER NOT LOADED, 


Informative message. 


Informative message. 

I/O errors or Logical errors were 
encountered in a run unit of the named CRF, 


This is a copy of a CRM statement that is 
in error, A subsequent message follows. 

An AAM request for CRM was issued by a task 
and the CRM Data Manager was not loaded 
into TAF at initialization time. 


The action depends on TAFREC 

the message preceding 
this one in the dayfile. 

None, TAFREC 

Attempt to recover any TAFREC 

good information using TAF 


the K.EROsYES initial K 
display command^ or 
initialize the file 
using the K,INT initial 
K display command. 

Inform the data TAF 

administrator. 

Check the DMS statements MSABT 

in the TCF which specify 
which data managers are 
to be loaded by TAF. 

For CRM users/ you need 
a DMS statement such as: 
DMS/CRM^ON^xx^xx^...,xx 


CRM DATA MANAGER SUCCESSFULLY LOADED. 

CRM ERROR nnnB IGNORED ON OPEN OF filenara. 

CRM ERROR ENCOUNTERED. 

CRM ERROR xxx IN UPDATE PROCESSOR. 

CRM ERROR IN ZZdbOIR (GET). 

CRM TASK RECOVERY IMPOSSIBLE. 

CRMTASK - DATA BASE DOWNED BY OPERATOR. 

CRMTASK - DATA BASE/FILE BEING IDLED. 

CRMTASK - DATA BASE/FILE CANNOT BE UPPED, 

CRMTASK - DATA BASE/FILE NAME UNKNOWN. 

CRMTASK - INCORRECT REQUEST. 

CRMTASK - INCORRECT REQUEST FORMAT. 


Self-explanatory. 

A non-fatal CRM error, nnnB, was returned 
to the TAF/CRM data manager while issuing 
CRM requests associated with opening a 
recoverable CRM file, filenam, for the 
first time. This error is ignored. 

A CRM error occurred while processing the 
directory. The CRM error is either an 
incorrect key or end of file when this is 
the only output message. 

A CRM error has occurred during the 
application of the after image to a data 
fi le. 


A CRM error was encountered when trying to 
retrieve a VSN record from the directory on 
a file load. 

Recovery is not possible when the recovery 
file structure is found to be inconsistent 
with TAF/CRM tables and parameters 
specified on xxJ files. 

OMREC notified TAF that the data base was 
recovered. But AAMI was not able to access 
it because it had been downed by the 
operator. 


AAMI will not process any requests on an 
idle data base/file. 


AAMI was not able to bring up the data 
base or fi le. 


DMREC request had an incorrect data base 
or file name. 


CRMTASK was not called correctly by DMREC. 


AAMI rejected this request. 


where xx * any data base 
identifier. 

None. 

Informative. 


Inform data 
administrator. 


Note which error has 
occurred and locate 
references to the error 
in the CRM/AAM Reference 
Manual for appropriate 
action. 

Inform data 
administrator. 


The Last reported BRF 
must be corrected or 
reallocated. 


Only an operator may up 
the data base that 
he/she downed. It 
cannot be upped 
automatically. 

After the cause of the 
data base/file being 
idle has been fixed, the 
operator must bring it 
up. 

Data administrator 
must investigate 
the cause of AAMI 
inability to bring 
file/data base up. 

Call the data 
administrator to 
investigate the cause. 

There may be a 
transaction in the 
system attempting to use 
functions reserved for 
DMREC. 

An analyst should 
investigate the reason 
for this rejection. 


TAF 

AAMI 


DMREC 


DMREC 

TAF 


DMREC 


AAMI 


CRMTASK 


CRMTASK 


CRMTASK 


CRMTASK 


CRMTASK 


CRMTASK 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

CRMTASK - INCORREa JJ SEQUENCE NUMBER. 

AAMI does not recognize the TT sequence 
number returned by DMREC. 

Call the analyst to 
investigate the 
discrepancy between 

DMREC and TAP. 

CRMTASK 

CRMTASK - NOT ALL DATA BASE FILES UPPED. 

DMREC recovered the data base but AAMI was 
unable to attach/open all of data base 
files. 

Data administrator 
should investigate why 
only some of the data 
base files came up. 

CRMTASK 

CRMTASK TIMEOUT. 

A terminal job timed out while waiting for 
the next command. 

A valid command roust be 
entered within the 
default time of 480 
seconds. 

CRMTASK 

CRT - CIO ERROR. 

A CIO error was generated when creating a 
log fi le. 

Purge the log file and 
try again (check file 
name). 

DMREC 

CSM - INCORRECT COMMUNICATION FUNCTION. 

An incorrect or unrecognizable request was 
received by the transaction executive from 
the CPU monitor. 

Inform site analyst. 

TAF 

CTASK - DATA BASE OR FILE DOWN. 

The data base, TAF/CRM, or file is down on 
an RSTDBl request. 

Inform the data 
administrator. 

CTASK 

CTASK - DATA BASE OR FILE IDLE. 

The data base, TAF/CRM, or file is idle on 
an RSTDBl request. 

Inform the data 
administrator. 

CTASK 

CTASK - FILE IS NOT INSTALLED. 

The data base or file is not available in 
the xxJ file on a CRMSTAT request. 

Inform the data 
administrator. 

CTASK 

CTASK - INCORRECT RECOVERY CASE. 

The recovery case selected for processing 
was incorrect. 

Inform the data 
administrator. 

CTASK 

CTASK - NO CRM RECOVERY FILES FOR DATA BASE. 

There is no recovery file assigned to the 
data base on an RSTDBl request. 

Inform the data 
administrator. 

CTASK 

CTASK SYSTEM IDENTIFIER UNKNOWN. 

The old system identifier is unknown when 
issuing a TINVOKE request. 

Inform the data 
administrator. 

CTASK 

CTASK - TABLE AREA NOT LARGE ENOUGH. 

Take table area supplied by CTASK for a 
CMRSTAT request is not large enough. 

Inform the data 
administrator. 

CTASK 

CTASK - TASK LOGICAL ERROR. 

An unexpected error status was returned. 

Inform the data 
administrator. 

CTASK 

CTASK - TRANSACTION NOT RERUNABLE. 

The TAP transaction was not rerunnable and 
a RERUN was attempted. 

Inform the data 
administrator. 

CTASK 

CTASK - TRMREC ERROR. 

One of the following occurred: 

- There was no outstanding D8EGIN request. 

Inform the data 
administrator. 

CTASK 


~ An error was encountered on a data base 


or recovery file- 

* The data base or TAF/CRN is down. 


CTASK - USER NOT DEFINED IN NETWORK FILE. 

The user specified on a TSTAT, WSTAT, or 

RERUN request is not defined in the NETWORK 
fi Le. 

Inform the data 
administrator. 

CTASK 

CYCLE NUMBER IS 

OUTSIDE LIMITS. 

The specified cycle nimiber is outside the 
limits set by the installation parameter 
(CYUCM). 

Check the maximum cycle 
number and rerun. 

DMREC 

(CYC) 

DATA BASE/FILE 

ALREADY DOWN OR IDLE. 

CRMTASK issued a DBOOWN request to AAMI, 
but the data base or file name was already 
down or idle. 

Inform data base 
administrator. 

CRMTASK 

DATA BASE/FILE 

CANNOT BE UPPED. 

CRMTASK issued a DBUP request but AAMI was 
not able to bring up the data base or file 
name. 

Inform data base 
administrator. 

CRMTASK 

DATA BASE/FILE 

NAME UNKNOWN. 

CRMTASK - issued a CRMSTAT, DBUP, or DBDOUN 
request but the data base or file name was 
not found. 

Inform data base 
administrator. 

CRMTASK 

DATA BASE NAME 
MATCH xxJ. 

IN CRM FILE NAME DOES NOT 

The two-character data base name from the 
file name on the CRM statement does not 
match the xxJ header. 

Correct the CRM 
statement and try again. 

DMREC 

DATA BASE NAME 

OR FILE NAME MISSING. 

No file name or data base name on directive. 

Include file name or 
data base name on 
directive. 

DMREC 

DATA BASE NAME 
SPECIFIED. 

OR FILE NAMECS) BOTH 

Self-explanatory. 

Eliminate file name or 
data base name from the 
directive. 

DMREC 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

DATA BASE NOT IN EOT 

Self-explanatory. 

Reinitialize the 
transaction executive, 
or inform the site 
analyst. 

TAF1 

DATA BLOCK BUFFER OVERFLON. 

ARF tape block size is too large for buffer 
allocated for it. 

Inform the data 
administrator and 
lengthen buffer WBUF. 

DMREC 

DATA MANAGER USAGE NOT SELECTED. 

A recoverable TAF transaction tried to use 
either the CDCS or CRM Data Managers and 
the usage of the data manager was not 
selected on the LIBTASK input which 
declared the named-transaction to TAF. 

Respecify the 
characteristics of the 
named-transaction via 
the LIBTASK directive, 
or design the 
transaction not to use 

CDCS or CRM Data 

Managers. 

MSABT 

DB - NAME MUST NOT START WITH THE LETTER Z. 

A data base name was found which starts 
with the letter Z. These are reserved 
names. 

Change the data base 
name to one not 
beginning with Z. If 
the name appears on an 

NCTF entry, contact the 
user and request a new 
identifier. If the name 
appears on the TCF, make 
the change on the 
applicable DMS statement 
or inform the data 
administrator. 

TAFREC 

DEFINE ERROR ON FILE. 

An error in defining PRU size or in trying 
to define the log file was encountered on a 
create directive. 

Correct PRU length on 
create directive. 

DMREC 

♦DEL* 

The system has deleted the last line of 
input. This occurred when the terminal 
operator entered the cancel character CCN) 
followed by the end of line/end of block 
terminator. 

None. 

CCP 

DELIMITER WAS NOT RECOGNIZED. 

An incorrect delimiter or an unrecognizable 
delimiter was encountered on a directive. 

Check directive format 
and rerun. 

DMREC 

DIRECTIVE CONTAINS AN INCORRECT DATE/TIME. 

A directive contains an unrecognizable 
date/time. 

Correct the directive 
and rerun. 

DMREC 

DIRECTIVE FORMAT ERROR. 

Error in one or more directive parameter 
formats. 

Correct directive and 
rerun. 

DMREC 

DIRECTIVE KEYWORD NOT VALID. 

The wrong delimiter on the directive 
parameter was used^ or the directive 
keyword is not valid. 

Correct directive and 
rerun. 

DMREC 

(SPR) 

DIRECTIVE NOT PRECEDED BY EDIT DIRECTIVE. 

This directive must be preceded by an edit 
directive. 

Include an edit 
directive. 

DMREC 

DIRECTORY HEADER FROM THE COPY. 

Informative message. 

None. 

OMREC 

DIRECTORY IS FULL-NO MORE ADDITIONS ALLOWED. 

The maximum length of the task Library 
directory has been reached. 

LIBTASK must be 
reassembled to allow for 
a Larger directory. 

LIBTASK 

DIRECTORY UNUSABLE. 

Attempt to reconstruct the directory failed. 

Check the output for the 
detailed error message. 

OMREC 

DISPLAY DUMP NOT ALLOWED TO TERMINAL. 

A 6-bit display code dump to a terminal is 
not allowed. 

Specify the 0 option on 
the KTSDMP command if a 
dump to a terminal is 
desired. 

KTSDMP 

OMREC COMPLETE. 

Informative message. The output file may 
contain other informative messages and 
should be reviewed. 

None. 

DMREC 

DMREC FAILED - xxxxxxx Z2. 

The DMREC job submitted by TAF failed, 
xxxxxxx is the directive being processed^ 
and zz is the data base name. 

Notify the data base 
administrator and 
correct as directed. 

DMREC 

DMREC TAPE LABEL ERROR. 

No tape header was found on ARF to be used 
for an update function. 

Check for correct ARF 
tape. Use alternate ARF 
tape if available. 

DMREC 

(UPD) 

DOWNED BRF TABLE OVERFLOW. 

Table of downed BRFs has overflowed. 

Inform data 
administrator. 

DMREC 

(BRT) 
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MESSAGE 


SIGNIFICANCE 


ROUTINE 


OSP ERROR ec RETURNED ON JOS ROUTE. 


DSP ERROR ec RETURNED ON TASK SUBMIT. 


DUMP TAPE SPECIFIES NON-STANDARD 
COMPRESSION. 

DUMP WILL START OVER 

end DUPLICATE CHARACTER 

DUPLICATE DATA BASE IN TCF - XX. 


DUPLICATE DUMP ENTRY ON ADD. 

DUPLICATE ENTRY ON ADO. 

DUPLICATE PARAMETER. 

DUPLICATE VSN ENTRY ON ADD. 

DXB CONVERSION ERROR ON TRANSACTION SEQUENCE 
NUMBER. 

ECS READ ERROR. 

ECS TASK taskneme NOW MS RESIDENT. 


ECS WRITE PARITY ERROR ENCOUNTERED. 
EDITING COMPLETE. 

END OF FILE REACHED. 

END OF VSN TABLE. 


ENTER NEXT TRANSACTION. 

ERROR IN ACCOUNT/USER CARO ARGUMENT. 

ERROR IN ADD/DELETE VSN. 

ERROR IN BRF PARAMETER IN xxJ FILE. 

ERROR IN BUILDING DIRECTORY ENTRIES. 

ERROR IN BUILDING RECOVERY TABLES. 


DSP has informed the transaction subsystem 
that an error was detected in routing a job 
for task dump processing, ec is the OSP 
error code. 

DSP has informed the transaction subsystem 
that an error other than a job or user 
statement error was detected, ec is the 
DSP error code. 

When trying to reload a record formatted 
dump tape/ the compression mode was 
nonstandard. 


DMREC attempted to execute the DUMP 
directive but encountered errors. 

The value you specified in the terminal 
definition command cmd conflicts with 
another terminal definition. 

Active data base identifier, xx, in the TCF 
is not unique. 


When trying to add a file dump entry to the 
directory with an add directive, a 
duplicate entry was found. 

When trying to modify the directory a 
duplicate of the entry was found. 


A duplicate VSN or duplicate file name was 
detected on a single directive. 

When trying to add a VSN entry to the 
directory with an add directive, a 
duplicate entry was found. 

An error occurred while converting the 
number in the table entry to binary. 

Self-explanatory. 

Task taskname could not be loaded into 
extended memory because of insufficient 
storage. It is loaded into mass storage. 


Self-explanatory. 

Informative message. 

Informative message. 

DMREC has reached the end of the VSN table 
on a LOAD or RECOVER process. 


Option C was selected to allow the entry of 
the next transaction. The previous 
recoverable information is lost. 

The charge or user statement in the xxJ 
file is in error. 

The number of added or deleted entries does 
not match the number of active files. 


The parameter on the BRF statement is 
non-numeric, or the value exceeds the 
installation parameter BMAX. 

An error was encountered when DMREC 
attempted to add or update a directory 
record. 

An error was encountered while attempting 
to retrieve a record from the directory 
file. 


ACTION 

Inform site analyst. 


Inform site analyst. 


Try loading from a 
previous dump tape and 
inform the data 
administrator. 

None. 


Try another value. 


Fix TCF so that xx 
appears only once among 
active (ON) DMS 
statements. 

List the directory for 
visual check and try 
again. 

List the directory and 
check for the needed 
entry. 

Correct directive and 
rerun. 

List the directory for 
visual check and try 
again. 

Inform data 
administrator. 

Inform customer engineer. 

If task must be resident 
in extended memory, more 
extended memory space 
must be allocated for 
the TAF user name. 

Refer to the NOS 2 
Installation Handbook. 

Inform customer engineer. 

None. 

None. 

Check the dayfile for 
possible tape errors 
which may cause this 
condition. 

Enter next transaction. 


Correct the charge/user 
statement and try again. 

Check edit directives 
and list the directory 
for a visual check. 

Correct value parameter. 


Inform data 

administrator, correct 
as directed and rerun. 

Try an update from an 
earlier file and inform 
the data administrator. 


TAF 


TAF 



DMREC 


DMREC 

CCP 

TAF 


DMREC 


DMREC 



DMREC 

DMREC 


DMREC 

TAF 

TAF 



TAF 

DMREC 

DMREC 

DMREC 



RTASK 


DMREC 

DMREC 

DMREC 


DMREC 

CBBE) 


DMREC 

(BRT) 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

ERROR 

IN BUILDING *RNKOEF* FILE. 

DMREC is trying to build a file of RMKDEF 
statements to be used in a subsequent 

MIPGEN run. An error has occurred in 
building the RMKDEF file. 

Make sure that RMKDEF 
statements are correctly 
formatted in the XXJ 
file; then rerun the 
program. 

DMREC 

GRM 

ERROR 

IN CRN CARD ARGUMENTS. 

The CRM statement in the xxJ file is in 
error. 

Correct the CRM 
statement and try again. 

DMREC 

ERROR 

IN CRM -PUT- (RECORD LOAD). 

An error was encountered while attempting 
to execute a CRM put onto the data file. 

Try to load from 
previous dump tape. 

DMREC 

ERROR 

IN EDIT PROCESSING. 

Editing processor has encountered an error 
in trying to execute the directive. 

Check the edit directive 
parameters and inform 
data administrator. 

DMREC 

ERROR 

IN IXN CARD ARGUMENTS. 

The IXN statement in the xxJ file is in 
error. 

Correct the IXN 
statement and try again. 

DMREC 

ERROR 

IN LIST PROCESSING. 

Errors in generating list as described on 
directive. 

Check list directive for 
accuracy and retry. 

DMREC 

ERROR 

IN LOADING AAMI. 

The loader encountered errors while loading 
the TAF CRM AAM interface (AAMI). 

The site analyst should 
consult the CYBER Loader 
Reference Manual (listed 
in the preface). 

TAF 

ERROR 

IN LOADING HASH CODE filename. 

The loader encountered errors while loading 
the hashing routine code that is on file 
filename. 

The site analyst should 
consult the CYBER Loader 
Reference Manual (listed 
in the preface). 

TAF 

ERROR 

IN LOADING NAN. 

The library file NETIO does not contain the 
entry points required for TAF. 

The site analyst should 
consult the CYBER Loader 
Reference Manual (listed 
in the preface). 

TAF 

ERROR 

IN LOADING TOTAL. 

The loader encountered errors while loading 
Total and the data base descriptor modules 
(DGMODs). 

The site analyst should 
consult the CYBER Loader 
Reference Manual (listed 
in the preface). 

TAF 

ERROR 

IN READING TASKLIB-fiLename. 

Error occurred during transaction executive 
initialization or extended memory-resident 
task loading. File specified as task 
library was incorrectly formatted; 
therefore^ it could not be read or loaded 
into extended memory correctly. 

Inform site analyst. 

TAF 

ERROR 

IN RECORD DUMP. 

During a record dump^ DMREC is unable to 
recognize the first record on the dump file 
as an FSTT. 

Check structure of file 
to be dumped for IS, OA 
or AK type and try again. 

DMREC 

ERROR 

IN RETRIEVING VSN. 

No VSN has been found in the directory that 
satisfies the directive. 

Check directive 
parameters. If correct, 
inform data 
administrator. 

DMREC 

ERROR 

IN SUBMITTED FILE. 

An incorrect parameter has been detected on 
a SU8MT call from a task. 

Correct task or inform 
data base administrator. 

MSABT 

ERROR 

ON xxJ FILE ARGUMENTS. 

The xxJ file contains statements in error^ 
which causes the transaction subsystem to 
abort. 

Examine xxJ file. 

Inform TAF data 
administrator. 

TAF 

ERROR 

STATUS nnnB ON BACKUP DIRECTORY. 

CRH error has occurred on directory file. 

Inform site analyst. 

DMREC 

(FER) 

ERROR<S) ENCOUNTERED IN OHREC PROCESSING. 

Fatal errors were encountered during 
processing. 

Check the output file 
for the detailed error 
message. 

DMREC 

FATAL 

CIO ERROR STATUS. 

A TAF CIO operation returned a fatal error 
status which aborted TAF. 

Inform site analyst. 

TAF 

FIELD 

LENGTH EXCEEDED FOR CMM. 

TAF does not have enough field length to 
allocate the space potentially recMi»‘ed by 
CMM. 

Increase TAF 
initialization field 
length. 

TAF 

FIELD 

LENGTH EXCEEDED FOR LOCKS. 

TAF does not have enough initialization 
field length for allocating lock tables. 

Decrease the locks 
parameter on the CRM 
statement, increase the 

TAF initialization field 
length, or inform site 
analyst• 

TAF 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

FIELD LENGTH EXCEEDED FOR RECORD. 

TAF does not have enough field length to 
allocate the space for the record buffer. 

Decrease the record size 
specified in the xxJ 
file or increase the TAF 
initialization field 
length. 

TAF 

FIELD LENGTH EXCEEDED FOR USERS. 

TAF does not have enough initialization 
field length for allocating file control 
tables. 

Decrease the users 
parameter on the CRM 
statement, increase the 

TAF initialization field 
length, or inform site 
analyst. 

TAF 

FILE ATTACH/DEFINE ERROR 

An error was detected in attaching or 
defining an ARF or BRF- 

Check the ARFs and the 

BRFs for attach mode and 
processing mode and 
correct if necessary. 

TAF1 

xxfUen - FILE^ ERROR ON LOCK FUNCTION. 

An error occurred while attempting to lock 
the specified file. Possible causes are: 

- No free file lock table entry (TKOK). 

- Another task has file locked. 

- Another task has record locked. 

Rerun the job at another 
time. If problem 
persists, increase the 
number of lock table 
entries. 

AAMl 

xxfilen - FILE^ ERROR ON OPEN FUNCTION. 

An error occurred while attempting to open 
the specified file. Possible causes are: 

- No free file control table entry (TFCB). 

- *CRM* error on OPEN function. 

- Incorrect key length. 

- Incorrect record length. 

Correct error. If not 
possible, contact site 
analyst. 

AAMI 

FILE XX J NOT FOUND. 

Transaction subsystem aborts. Data base in 
TCF file has no xxJ file, or a PFM error 
occurred. 

Inform TAF data 
administrator or site 
analyst. 

TAF 

FILE NAME CONFLICT. 

The input file name specified on the KTSDMP 
command is the same as the output file name 
specified. 

Correct error and rerun. 

KTSDMP 

FILE NAME MISMATCH ON TAPE HEADER RECORD. 

File name on ARF tape and attached ARF 
don't match. 

Check file name on ARF 
tape being used. 

DMREC 

FILE NAME MUST BE 2-7 CHARACTERS, 

The xxpfni parameter on the CRM statement 
must be two to seven characters, the first 
two <xx} being the data base name. 

Correct the xxpfni 
parameter on the CRH 
statement or inform 
data administrator. 

TAF 

FILE NOT ATTACHED - filename. 

Either the P or the N parameter file was 
not attached when the DA option was used; 
filename is the permanent file name. 

Ensure that the file is 
defined or attached 
prior to entering the 

LIBTASK statement. 

LIBTASK 

FILE hash NOT FOUND. 

The indirect file named hash containing the 
binary code of the hashing routine was not 
found under the username parameter on the 

USER statement in the xxJ file or a PFM 
error occurred. 

Ensure that file hash is 
saved under the username 
parameter or inform data 
administrator. Consult 
the CYBER Loader Reference 
Manual (listed in the 
preface). 

TAF 

FILE ORGANIZATION IS NOT IS, DA OR AK. 

The file organization parameter on the CRM 
statement was not specified as either IS, 

DA, or AK. 

Correct the CRM 
statement and try again. 

DMREC 

FILE TCF EMPTY. 

An empty TCF exists under the TAF user name. 

Place the necessary 
information on TCF. 

TAF 

FILE TCF NOT FOUND. 

The TCF was not found under the user name 
of the Transaction Facility. 

Create a TCF file under 
the TAF user name. 

TAF 

FILE TYPE MUST BE AK, DA, OR IS. 

The type parameter on the CRM statement 
must be AK (actual key), IS (indexed 
sequential) or DA (direct access). 

Correct the type 
parameter on the CRM 
statement or inform the 
data administrator. 

TAF 

FILE TYPE NOT ARF OR BRF. 

On a create function a file name was used 
that does not conform to the ARF/BRF naming 
conventions. 

Check file name on 
create directive. 

DMREC 

FL TOO LARGE- nnnnnnB,taskname,tasklibrary. 

The initial load field length, nnnnnnB, for 
task taskname on task library tasklibrary 
exceeds the minimum size of the transient 
task area (potential space available to 
contain transient tasks). Thus a situation 
could arise in which it would not be 
possible to load the task. 

Correct error. 

TAF 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


FORMAT ERROR IN THE NCTWORK DESCRIPTION 
FILE. 

FSTT READ ERROR. 

FWA .GE. LWA+1. 


GET ERROR ON PF xxxxxxx. 


HOST AVAILABLE CONTROL CHARACTER^Char 

display 

ENTER INPUT TO CONNECT TO HOST 


HOST BUSY CONTROL CHARACTER®char 

display 

ENTER char HD TO SEE HOST STATUS 


HOST CONNECTED CONTROL CHARACTER® char 

display 

READY FOR INPUT 


HOST CONNECTED CONTROL CHARACTER®char 

display 

TERMINAL DISABLED BY NOP 


HOST CONNECTED CONTROL CHARACTER® char 

display 

READY FOR INPUT 


HOST DISCONNECTED CONTROL CHARACTER®char 
display 

ENTER INPUT TO CONNEa TO HOST 


HOST DISCONNECTED CONTROL CHARACTER®char 
display 

TERMINAL DISABLED BY NOP 


HOST NOT AVAILABLE. 


During transaction executive 
initla 11 ration^ one or more errors were 
found to exist In the network description 
fi le. 

No FSTT found on a record load dump tape. 

There Is a logical error In the structure 
of the Input file which implies that the 
first word address Is greater than or equal 
to the last word address plus one. 

No Indirect access permanent file, for use 
as an own code file, has been found. 


Your selected host is available, 

display The host availability 

display (KAO), which 
appears if you have enabled 
It using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

The host rejected your attempt to connect, 
display The host availability 

display CHAD), which only 
appears if you have enabled 
it using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

You are connected to the host. 

display The host availability 

display (HAD), which 
appears if you have enabled 
It using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

The network operator has disabled your 
terminal. No further Input Is possible, 
display The host availability 

display (KAO), which 
appears if you have enabled 
It using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

You are connected to the host. 

display The host availability 

display (KAO), which 
appears if you have enabled 
It using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

You have been disconnected from the host, 
display The host availability 

display (HAD), which 
appears if you have enabled 
It using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

The network operator has disabled your 
terminal. No further input is possible, 
display The host availability 

display (HAD), which 
appears If you have enabled 
it using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

NAM is not communicating with the 255x 
communications processors. Either NAM was 
not initialized or has since failed. 


Inform site analyst. 


Load from previous tape. 
Inform data base administra 


Check for the presence 
of the file and try 
again. 

Enter any Input to 
Initiate your connection 
to the host. 


Check the status of 
the hosts In your 
configuration. 


Proceed with your login 
to the host. 


None. 


Proceed with your login 
to the host. 


None. 


None. 


Initialize NAM if it was 
not Initialized 
previously; inform site 
analyst if NAM was 
active but a malfunction 
occurred. 


TAF 

DMREC 

KTSDMP 

DMREC 

CCP 

CCP 

CCP 

CCP 

CCP 

CCP 

CCP 

TAF 
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MESSAGE 


SIGNIFICANCE 


ACTION 


HOST UNAVAILABLE CONTROL CHARACTERschar 

display 

ENTER chap HO TO SEE HOST STATUS 

IGNORE TABLE OVERFLOW. 

XX ILLEGAL COMMAND 

ILLEGAL DATA BASE IN xxj PILE. 

ILLEGAL FL REDUCTION. 

ILLEGAL JOURNAL FILE REQUEST. 

ILLEGAL KEY BEGINNING CHARACTER. 

ILLEGAL KEY ORDINAL. 

ILLEGAL LIBTASK ATTEMPT - fUenanie, 
username. 

ILLEGAL NUMBER FOR LOCKS. 

ILLEGAL NUMBER FOR USERS. 

ILLEGAL NUMBER OF ALTERNATE KEYS. 

ILLEGAL PARAMETER IN RA+1 CALL. 

ILLEGAL TASK NAME REQUESTED FOR SCHEDULING. 

cmd ILLEGAL TERMINAL CLASS 

ILLEGAL TERMINAL INPUT REQUEST. 

cmd ILLEGAL VALUE 

INACTIVE TASK REQUESTED. 

INCOMPLETE PARAMETER. 


ROUTINE 


You have attempted a connection to a host 
that is not up. 

display The host availability 

display (HAD)/ which 
appears if you have enabled 
it using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

Check the status of 
the hosts in your 
configuration. 

CCP 

Ignore table/ TTIG/ is too small. 

Inform site analyst to 
enlarge TT16 table. 

DMREC 

The characters xx must be a terminal 
definition mnemonic or interactive status 
command. 

Ensure the accuracy of 
your entry and retry. 

CCP 

One of the statements in the xxJ file 
specifies an incorrect xx parameter and 
causes the transaction subsystem to abort. 

Examine xxJ files. 

Inform the TAF data 
administrator. 

TAF 

Task request to reduce FL would cause the 
last word address of the communication 
block to be outside the task FL. 

Inform data 
administrator. 

MS AST 

Either a task requested that an entry be 
made on an undefined TAF journal file/ or 
the task attempted to make an entry longer 
than 2499 CM words on a TAF journal file. 

Inform data base administra 

MSABT 

The key offset parameter on an AKY 
statement in the xxJ file/ is missing or 
incorrect. 

Correct AKY command. 

TAF 

(AKY) 

The key ordinal parameter on the AKY 
statement is missing or incorrect. 

Correct AKY statement. 

TAF 

(AKY) 

The transaction executive validates all 
dynamic attempts to change the task library 
by comparing the user name of the requester 
against the list of data base user names. 

If it does not match/ or if the library 
file is not attached by TAF/ the 
transaction executive issues this dayfile 
message/ where username is the user name of 
the incorrect attempt. 

Correct and reinitialize 
transaction executive. 

TAF 

The locks parameter on the CYBER Record 
Manager (CRM) statement is in error. One 
of the following format conditions exists. 

- A nonnumeric character. 

- A character after a postradix of B or D. 

- An 8 or 9 with a postradix of B. 

Correct the locks 
parameter on the CRM 
statement or inform the 
analyst. 

TAF 

The user's parameter on the CRM statement 
is in error. One of the following format 
conditions exists. 

- A nonnumeric character. 

* A character after a postradix of 8 or D. 

- An 8 or 9 with a postradix of B. 

Correct the user's 
parameter on the CRM 
statement or inform the 
data administrator. 

TAF 

The number of alternate keys on the IXN 
statement is missing or incorrect. 

Correct IXN statement. 

TAF 

(IXN) 

A task error. The parameters specified in 
a request from a task are either 
insufficient or incorrect. 

Correct task or inform 
data base administrator. 

MSABT 

The task requested was not found in the 
task library directory. 

Correct task or inform 
data base administrator. 

MSABT 

The value you specified in the terminal 
definition command cmd is not valid for 
your terminal. 

Choose an appropriate 
value (refer to appendix 

J>. 

CCP 

A task error. A UAITINP request was issued 
by a memory resident task or by a task that 
did not originate from a terminal. 

Correct task or inform 
data base administrator. 

MSABT 

You specified an invalid value in the 
terminal definition command cmd. 

Choose a valid value 
(refer to appendix J). 

CCP 

An attempt was made to schedule a task 
which has been turned off with a K.OFFTASK 
command or a LIBTASK directive. 

Correct condition or 
inform site analyst. 

OFFTASK 

A parameter on a DMREC directive was not 
completed correctly. 

Correct the parameter on 
the faulty directive. 

DMREC 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


INCORRECT COMMAND. 

INCORRECT COMMON MEMORY MANAGER REQUEST. 

INCORRECT FAMILY NAME IN EOT. 

INCORRECT FWA FOR LOAD. 

INCORRECT POSniON IN THE DIRECTORY. 

INCORRECT SUB-TRANSACTION CODE - INITIAL TASK. 

INCORRECT TOTAL INTERLOCK REQUEST. 


INCORRECT WORD COUNT ON TERMINAL OUTPUT. 


INITIAL TASK NOT IN TASK LIBRARY DIRECTORY. 

INITIALIZATION OPTIONS. 

INPUT DISCARDED 

INPUT DISCARDED 

INSUFFICIENT FIELD LENGTH FOR THIS COMMAND. 

INSUFFICIENT FL FOR DATA MANAGER. 


One of the following errors occurred: 

1. A coflunand was entered other than what 
was on the menu. 

2. A terminal CRMSTAT request did not 
request its own data base. 

3. A terminal origin job tried to request 
the menu. 

4. Unpack errors on the terminal message. 

Memory request with reserved bits in the 

parameter block set incorrectly. 

Self-explanatory. 


The FUA of the load was not equal to 11IB. 
Task binaries must be in absolute format. 


The directory structure is inconsistent or 
positioning is incorrect. 

There is an unrecognizable subtransaction 
code in the terminal input. 


One of the following. 

- A task that is not on the system task 
library issued a CHKON request. 

- A task issued a CHKON request with a 
CHKON request already in effect. 

- A task issued a CHKOFF request without 
first issuing a CHKON request. 

- A task that issued a CHKOFF request had 
a sequence number different from a task 
that issued a CHKON request. 

One or more of the following task errors 
occurred on a SEND request. 

- The word count was less than or equal to 
zero. 

- There was an attempt to use SEND MAXWS 
or more CM words of information in one 
SEND; MAXWS is an installation option. 

- There was an attempt to use SEND MAXTO 
or more CM words of information by one 
task through a series of SEND requests. 
MAXTO is an installation option. 

The task library file does not contain the 
initial task (ITASK). 

This message precedes messages indicating 
the values of the initial K display options 
either during initialization or recovery. 

The network has discarded the last input 
from your terminal. May be caused by 
entering a user break or interactive status 
command while awaiting a response to a 
previous user break or interactive status 
command. 

The system has discarded user input. 

CRMTASK issued a CRMSTAT request but AAMI 
was not able to complete it because the 
table area supplied by the user was not 
large enough. 

The transaction executive requires more 
field length at initialization time than is 
available. 


Ensure that the command 
is correct. If problem 
persists,, inform the 
site analyst. 


Do not set reserved bits. 


Reinitialize the 
transaction executive or 
inform the site analyst. 

Ensure that the correct 
load procedure is 
performed. 

Inform data 
administrator. 

Correct terminal input 
or inform data base 
administrator. 

Inform data base 
administrator. 


Correct task or inform 
data base administrator. 


Inform site analyst. 


None. 


Reenter your last input. 


Reenter input. 

Inform data base 
administrator. 


Correct error and 
reinitialize executive. 


INTERMEDIATE IGNORE TABLE OVERFLOW. 


INVALID DATA BASE NAME ON DMS STATEMENT. 


Intermediate ignore table FTAB is too 
small. Too many potentially recoverable 
files have been encountered when reading 
ARF's. 

A data base name associated with TAF, CRM, 
or OTHER exceeds two characters. 


Inform site analyst to 
enlarge table FTAB. 


Correct the DMS 
statement on TCF file. 


INVAUD DATA MANAGER PARAMETER 


An error has been detected in the parameter Correct the data manager 
list on a data manager request. request statement. 


CRMTASK 


MSABT 

TAF1 


LIBTASK 

DMREC 

(GPL) 

MSABT 


MSABT 


MSABT 


TAF 

TAF 


CCP 


TAF1 

CRMTASK 


TAF 


DMREC 

(BRT) 


TAF 

MSABT 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

INVAUD TASK NAME. 

The error message was Issued for one of the 
following reasons: 

- Initialization of a task by the name of 
BTASK, CTASK, ITASK, KDIS, MSABT, 

OFFTASK, RCTASK, RTASK, SYSMS6, or XTASK 
was attempted using XTASK. These are 
names of required system tasks and will 
not be initiated by XTASK. 

- A zero length task name was specified. 

• A task name of more than seven 

characters was specified. 

Correct the task name. 

XTASK 

INVALID TCF ENTRY. 

The previous dayfile mesage is the 
statement in TCF which is incorrect. 

Correct that statement 
in TCF. 

TAFREC 

INVALID TRANSACTION DIRECTORY HEADER - 
fi Lenacne. 

The transaction directory (TRD) header word 
is not TRD. 

Inform TAF site analyst. 

TAF 

fiLenam IS INCONSISTENT. 

The inconsistent file bit is set for 
recoverable file, filenam. This indicates 
a failure (either of TAF or the sytem) 
occurred while CRM was trying to update 
more than one block. All of the blocks may 
not have been updated and this would cause 
the file to be flagged as inconsistent. 

It is necessary to 
recover the affected 
file. AANl will submit 
an OMREC job to do this. 

A AM I 

xxJ FILE ERROR - CRM DM NOT LOADED. 

A data manager related statement is 
specified in the xxJ file but that data 
manager is not loaded on to TAF. 

Inform site analyst to 
change the xxJ or TCF 
file. 

TAF 

xxJ FILE ERROR - TAF DM NOT LOADED. 

A data manager related statement is 
specified in the xxJ file but that data 
manager is not loaded on to TAF. 

Inform site analyst to 
change the xxJ or TCF 
file. 

TAF 

xxJ FILE ERROR - TOTAL DM NOT LOADED. 

A data manager related statement is 
specified in the xxJ file but that data 
manager is not loaded on to TAF. 

Inform site analyst to 
change the xxJ or TCF 
file. 

TAF 

XX J FILE NOT FOUND* 

When using the TAF*s user name and 
password, an xxJ file for this data base 
was not found. 

Ensure xxJ file exists 
for this data base and 
try again. 

DMREC 

JOURNAL TYPE DOES NOT MATCH xxJ FILE. 

TAF journal file entries in the xxJ file do 
not match the files themselves. This 
causes the transaction subsystem to abort. 

Inform TAF data 
administrator. Examine 
xxJ file for the TAF 
journal file entries. 

TAF 

K.BFL^n. 

K.CMB=nn. 

K.£CS=nnnK. 

K.ERO-a. 

K.ERO=CRF,xxx. 

K. INT=1. 

K.INTsCRF^xxxxxxx. 

K.INT=?CRM,xxxx. 

K.MDM^n. 

K.MFL=nnnnnnB. 

K.REC-a. 

K.SCP«nn. 

K.TLF=a, 

Values of the initial K display options at 
either initialization or recovery. 

None. 

TAF 

K. COMMAND NOT VALID. 

A K. command in the TCF file is improperly 
formatted. 

Correct the statement in 
the TCF or inform the 

TAF analyst. 

TAF 

K-DISPUY COMMAND UNSUCCESSFUL, DROP 
IGNORED—command. 

A K.DROP or K.DDROP could not be processed 
because the task was in recall, the 
interactive executive denied a request, or 
a command was issued during the initial 
load of the task. The command field is the 
attempted command or request; blanks 
indicate no command was issued. 

Reenter the K.DROP or 
K.DDROP command. When 
the recall operation, 
time-sharing request, or 
initial load operation 
is completed, TAF 
accepts the command and 
aborts the task. 

SYSMSG 

K-DISPLAY COMMAND UNSUCCESSFUL, FORMAT 
ERROR—command. 

There is an error in the syntax of the 
command or in one of the parameters. The 
command field is the attempted command or 
blanks if the command is longer than seven 
characters or contains an incorrect 
character. 

Correct the command and 
retry the operation. 

SYSMSG 

K-DISPLAY COMMAND UNSUCCESSFX, ILLEGAL 
COMMAND—command. 

The command is not a valid K display 
command or was misspelled. The command 
field is the attempted command. 

Correct the command and 
retry the operation. 

SYSMSG 

K DISPLAY COMMAND UNSUCCESSFUL, SYSTEM 
BUSY—command. 

The system is busy and cannot respond to 
the request. The command field is the 

Retry the operation. 

SYSMSG 


attempted command* 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


K.MAXFL^nnnnnnB. 

The run-time K display command K.MAXFL was 
entered with the indicated value. 

None. 

TAF 

K.MAXFL REJECTED. 

A value was entered which caused potential 
blocked tasks to be detected. 

Reenter K.MAXFL with a 
larger value. 

TAF 

KEYWORD IS 

ILLEGAL FOR THIS FUNaiON. 

A keyword was used that is not valid for 
the selected directive. 

Check format of 
directive and valid key 
words for that directive. 

OMREC 

n.nnn KILO 

CDCS REQUEST REJECTS FOR BUSY. 

Total number of SSC rejects for busy when 

Less than seven outstanding CDCS SSC 
requests existed at the time of the current 
request. 

None. 

TAF 

n.nnn KILO 

CDCS REQUEST REJECTS FOR MAXR. 

Total nunber of SSC attempts when there 
were seven <MAXR) outstanding CDCS SSC 
requests. 

None. 

TAF 

n.nnn KILO 

CDCS REQUESTS FROM TASKS. 

Total number of CDCS SSC requests issued by 
tasks. The number does not include 
terminate requests which are blocked by TAF. 

None. 

TAF 

n.nrn KILO 

ITASK RELOADS. 

Upon transaction facility termination/ this 
message indicates how many reloads of ITASK 
occurred. Because ITASK is a central 
memory resident task/ if it makes a fatal 
error^ it must be reloaded. 

Inform site analyst. 

TAF 

n.nnn KILO 

LOCK REJECTS-filename. 

TAF CRM could not lock records in filename 
for a task because the locks parameter on 
the CRM statement for that file was not 
large enough. 

The site analyst should 
consider increasing the 
locks parameter on the 

CRM statement if lock 
failures occur 
frequently. 

TAF 

n.nm KILO 

LOCKS'* filename. 

TAF CRH processed nnnn locks for file 
filename. 

None. 

TAF 

n.nnn KILO 

NO COMMUNICATION BLOCKS. 

Upon transaction facility termination/ this 
message indicates the nunber of times a 
communication block was needed and was not 
available. 

Inform site analyst. 

The site analyst might 
want to consider using 
the K.CMB command during 

TAF initialization. 

TAF 

n.nnn KILO 

NO FL FOR TASK LOAD. 

Upon transaction facility termination/ this 
message indicates the nunber of times TAF 
was unable to obtain enough memory to load 
tasks. 

Inform site analyst. 

The site analyst might 
want to consider using 
the K.MFL command during 

TAF initialization. 

TAF 

n.nnn KILO 

NO SUBCONTROL POINTS. 

Upon transaction facility termination/ this 
message indicates the nunber of times a 
subcontrol point area was needed and was 
not available. 

Inform site analyst. 

The site analyst might 
want to consider using 
the K.SCP command during 

TAF initialization. 

TAF 

n.nrm KILO 

OPEN REJECTS'*filename. 

TAF CRM could not open file filename for a 
task because the user's parameter on the 

CRM statement is not large enough. 

The site anlayst should 
consider increasing the 
users parameter on the 

CRM statement if open 
failures occur 
frequently. 

TAF 

n.nnn KILO 

OPENS-filename. 

TAF CRM processed nnnn opens for file 
filename. 

None. 

TAF 

n.nnn KILO 

STORAGE MOVES OF TASKS. 

Upon transaction facility termination/ this 
message indicates the nunber of subcontrol 
points that were moved. This is done to 
make more effective use of the field length 
of TAF. 

None. 

TAF 

n.nnn KILO 

TAF FL INCREASES. 

Upon transaction facility termination/ this 
message indicates the nunber of times TAF 
increased its field length while trying to 
satisfy an internal request for a block of 
memory. This internal request is often 
issued to obtain memory in which to load a 
task. 

None. 

TAF 

n.nnn KILO 

TASK RECALLS. 

Upon transaction facility termination/ this 

None. 

TAF 


nessage indicates the nunber of times tasks 
were put in recall. This is an internal 
statistic over which the applications 
programmer has little control. 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


n.ntm KILO TASK RECALLS FOR OUTPUT. 


n.nnn KILO TASK RELOADS. 


n.rtnn KILO TASK ROLLOUT COMPLETES. 


n.nnn KILO TASK ROLLOUT STARTS. 


n.nnn KILO TRANSACTION ABORTS. 

n.nm KILO TRANSACTIONS PROCESSED. 

KL PARAMETER OR CRM CARD NOT SPECIFIED 
PROPERLY. 

KTSDMP COMPLETE. 

LBL - CIO ERROR. 

LIBRARY DIRECTORY EMPTY - filename. 

LIBRARY DIRECTORY ERROR - filename. 

LIBRARY DIRECTORY TOO LONG - filename. 

LIBRARY FILE TIME OUT. 


Upon transaction facility termination^ this 
message indicates the number of times tasks 
were put in recall because the network 
block Limit CN6L parameter on a TERMINAL 
statement) for the terminal in use was 
reached. 

Upon transaction facility termination^ this 
message indicates how many reloads of tasks 
occurred. TAF reloads tasks that have 
fatal errors if one of the following is 
true. 

- The task is central memory resident. 

' There are queued transactions waiting to 
use the task. 

Upon transaction facility termination, this 
message indicates the nunber of times TAF 
rolled out tasks. This statistic excludes 
the number of times the rollout operation 
did not complete. 

Upon transaction facility termination, this 
message indicates the number of times TAF 
initiated a rollout operation. Rollout 
includes writing a task to disk and 
releasing the task subcontrol point space. 
In some cases, the task is allowed to stay 
central memory resident for a while before 
it is rolled out. 

Upon transaction termination, this message 
indicates how many transaction tasks have 
aborted. 


Upon TAF termination, this message 
indicates the number of TAF transactions 
processed. 

The KL parameter or the CRN statement was 
specified improperly or specified as zero 
length. 

Dump completed normally. 

A CIO error was encountered because no 
trailer record was found on a block load. 

The task library file indicated does not 
contain a directory. 

The task library file indicated contains a 
nonrecognizable directory. 

The directory record on the task library 
file indicated exceeded the maximum length 
allowed by the transaction executive (398 
entries)• 

The Library file was busy for the length of 
time specified by an assembly constant, so 
LIBTASK was unable to attach it. Another 
user apparently has the file attached and 
will not allow modification. 


Refer to the Network 
Access Method Network 
Definition Language 
Reference Manual (listed 
in the preface). 


Inform site analyst. 


None. 


None. 


Data administrator may 
have to correct data 
base to account for 
transactions. 

None. 


Correct the CRM 
statement and try again. 


None. 

Load from previous dimtp 
tape. 

Inform site analyst. 
Inform site analyst. 
Inform site analyst. 


Retry at a later time. 


LIBTASK ERROR CONDITION UNKNOWN. 

LIBTASK PFM ERROR DETECTED. 

LIST COMPLETE. 

LOAD ERROR IN HASHING ROUTINE. 


The error condition for the error Inform data base administra 

processing routine ERR within LIBTASK was 

unknown. 


A permanent file error other than FILE BUSY Correct and rerun, 
was received when the library file attach 
was attempted. 

Informative message. None. 


When attempting to load the hashing routine Check for valid hashing 

on a record load operation, a load error or routine, inform analyst, 

no entry point in the hashing routine was 
found. 


LOADING ECS taskname. 

Informative message, 
subsystem is loading 

The 

task 

transaction 

taskname. 

None. 

LOG ENTRY TABLE OVERFLOW. 

Too many recoverable 
exist on ARF. 

data 

base file names 

Increase 
(TLOG). 


TAF 

TAF 

TAF 

TAF 

TAF 

TAF 

DMREC 

KTSDMP 

DMREC 

TAF 

TAF 

TAF 

LIBTASK 

LIBTASK 

LIBTASK 

DMREC 

DMREC 

TAF 

DMREC 

(8LT) 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


MAXIMUM TERMINALS EXCEEDED. 


MEMORY OVERFLOW DURING INITIALIZATION. 


MEMORY REQUEST FOR ECS NOT ALLOWED, 


MEMORY REQUEST WITH D.M. 
REQUEST OUTSTANDING. 

MFL TOO LARGE * 

nnnnnnB, taskna(ae,tasicUbrary. 


MINIMUM TAF MFL NEEDED » nnnnnnB. 


MISSING AKY CARD. 

MISSING HEADER WORD ON xxJ FILE. 

MISSING HEADER WORD ON XXJ FILE. 

MORE THAN FIVE TASKS IN TASK CHAIN. 

MORE THAN ONE ARF SPECIFIED. 

MORE THAN ONE ENTRY POINT ON A *54* TABLE. 

MORE THAN ONE USER STATEMENT IN TCF. 


More than IPTST transaction terminals have 
been defined in the Network FileCs). 


TAF aborted because its field length for 
initialization was insufficient. 


Incorrect request of extended memory by 
task. 

A task error. MEM or RFL request attempted 
with data manager requests outstanding. 

The MFL (initial field length plus 
expandable field length) of the non-CM 
resident task (taskname) on task library 
(tasklibrary) exceeds the minimum size of 
the transient task area (potential space 
available to contain transient tasks). 

Thus a situation could arise in which it 
would not be possible to complete 
processing of this task. 

Potentially blocked tasks were detected at 
one of the following times: 

- TAF initialization 

- Attempted task library update 

- Attempt to change TAF maximum FL via 
K.MAXFL command 

The above operation did not complete 
normally. The maximum FL of TAF must be at 
least nnnnnnB. If nnnnnnB exceeds the 
Largest field length possible for TAF 
(377700 b), then other corrective action is 
needed. 

Number of AKY statements does not match 
nuaber of alternate keys on IXN statement. 


The first statement on the xxJ file is in 
error, causing the transaction subsystem to 
abort. 

No header word on xxJ was found. 


A task error. Only five tasks can be 
requested for scheduling in one CALLRTN, 
CALLTSK, or NEWTRAN request; more than five 
were requested. 

More than one ARF was specified on the DUMP 
directive. 

Multiple entry points are not allowed in 
tasks. 

Self-explanatory. 


Reduce number of 
terminal definition 
statements or increase 
IPTST and reassemble 
TAFREC. 

Inform site analyst. 

IFL« in deck TAF should 
be increased. 

Increasing the central 
memory field length 
parameter on the RFL 
command in the TAF 
initialization procedure 
file (ffff) does not 
correct this problem. 

Contact data 
administrator. 

Correct task or inform 
data base administrator. 

Reduce the task FL or 
EF, or increase the TAF 
FL. 


Correct error. 


Modify the IXN statement 
or adjust the nunber of 
AKY statements so the 
two match. 

Examine xxJ files for 
header xxJ. Inform the 
TAF data administrator. 

Correct xxJ file and 
rerun. 

Correct task or inform 
data base administrator. 


Correct the directive 
and rerun. 

Rewrite the task with 
only one entry point. 

Delete the extra 
USER statement. 


TAFREC 


TAF 


MSABT 

MSABT 

TAF 


TAF 


TAF 

(XXJ) 

TAF 

DMREC 

MSABT 

DMREC 

LIBTASK 

TAFREC 


MRL PARAMETER ON CRM CARO NOT SPECIFIED 
PROPERLY. 


The MRL parameter on the CRM statement was 
specified improperly or specified as zero 
length. 


Correct the CRM DMREC 

statement and try again. 


NS REDUaiON INVALID - filename. 


The maximum message size, specified via the 
MS parameter on the RECOVER directive, was 
less than the actual message record size on 
the named CRF, 


Correct the RECOVER 
directive or select 
initialization of the 
named CRF via the K.INT 
initial K display 
command if reducing the 
message size is actually 
required. (Note that 
K.INT will destroy the 
current recovery 
information). 


TAFREC 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTING 

MSABT CALL ERROR. 

MSABT was called with an incorrect error 
code. 

Inform data base 
administrator. 

MSABT 

NAKY PARAMETER ON THE IXN CARO NOT SPECIFIED 
PROPERLY, 

The NAKY parameter is not specified 
properly or of zero length. 

Correct the IXN 
statement and try again. 

DMREC 

NAM ERROR - ILLOGICAL ABT. 

The application block type <ABT) sent to 

TAF by NAM is unrecognizable. 

Contact Central Software 
Support. 

TAF 

NAM ERROR - INCORRECT ASH. 

The application block header CASH) sent to 

TAF by NAM is unrecognizable. 

Contact Central Software 
Support. 

TAF 

NAM FUNCTION NOT FOUND. 

TAF received a supervisory message from NAM 
which had an unrecognizable primary or 
secondary function code. 

Contact Central Software 
Support. 

TAF 

NAM LOGICAL ERROR. 

NAM sent TAF a message out of order or an 
unrecognizable message. 

Contact Central Software 
Support. 

TAF 

NAM NOT AVAILABLE. 

Informative message indicating that TAF is 
currently at a control point but NAM is 
not. TAF transactions can be initiated 
from batch only, or TAF-CRM data bases may 
be accessed from batch or interactive jobs. 

Bring NAM to a control 
point, if desired. 

TAF 

NAM PHYSICAL ERROR ECsec. 

NAM has detected a physical error indicated 
by error code ec. 

Refer to the NAM 

Reference Manual for the 
meaning of this error 
code. 

TAF 

NAM REJECT. 

During login processing, NAM rejected the 
terminal. 

Inform site analyst. 

TAF 

NEED AT LEAST xx SU8C0NTR0L POINTS. 

There are more CM resident tasks defined 
than subcontrol points. If non-CM resident 
tasks exist, there must be at least one 
more subcontrol point than there are CM 
resident tasks. 

Reinitialize the 
transaction executive 
and assign more 
subcontrol points, or 
reduce the number of CM 
resident tasks. 

TAF 

NETOFF COMPLETE. 

Informative message indicating that TAF is 
no longer communicating with NAM. NAN 
initiated shutdown procedures prior to loss 
of communications. 

When NAM is available, 
the central site console 
operator command K.NAMON 
can be used to resume 
communications between 

TAF and NAM. 

TAF 

NETON COMPLETE. 

Informative message indicating that TAF is 
communicating with NAM. 

None. 

TAF 

NETWORK FILE NOT FOUND - filename. 

The network description file, NCTFi, could 
not be found. 

Check that correct 
parameters were 
specified on the NETWORK 
directive corresponding 
to filename. 

TAF 

TAFREC 

NETWORK SHUT DOWN DETECTED. 

Self-explanatory, 

None. 

TAF 

NM REDUCTION INVALID - filename. 

The maximum number of user messages, 
specified by the NM parameter on the 

RECOVER directive, was less than the actual 
number of user messages on the named CRF. 

Correct the RECOVER 
directive or select 
initialization of the 
named CRF via the K.INT 
initial K display 
command if reducing the 
nunber of user messages 
is actually required. 

(Note that K.INT will 
destroy the current 
recovery information). 

TAFREC 

NO ACCOUNT/USER CARD IN xxj FILE. 

The USER statement in the xxJ file is not 
present, causing the transaction subsystem 
to abort. 

Add USER statement in 
xxJ file. Inform the 

TAF data administrator. 

TAF 

NO ACCOUNT/USER CARD ON XXJ FILE. 

No user statement exists on the xxJ file. 

Correct the xxJ file and 
rerun. 

DMREC 

<CXJ) 

NO ALTERNATE KEY SPECIFIED ON IXN CARD. 

Self-explanatory. 

Correct the IXN 
statement and try again. 

DMREC 

NO ARF DUMP ENTRIES - DUMP IGNORED. 

When trying to build directory entries for 
an ARF dump function, no ARF file was found. 

Include ARF file name on 
dump. 

DMREC 

NO ARF DUMP ENTRIES IN DIRECTORY. 

A search of the directory for the targeted 
VSNs of ARF tapes was unsuccessful. 

Check time and data or 

VSN used to del ineate 
update. 

DMREC 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

NO 8RF CARD FOR CRM DATA BASE. 

There is no BRF statement in the xxJ file 
before the first CRM statement for the data 
base. 

A BRF Statement is 
required. If no 
recovery is desired, the 
number of specified 
files on the BRF should 
be zero. 

TAF 

NO 8RF CARD FOUND IN xxJ FILE. 

There is no BRF statement in the xxJ file 
for the data base. 

A BFF card is required 
and must be added to the 
xxJ file. 

DMREC 

NO CRM CARO FOUND IN xxJ PILE. 

Self-explanatory. 

Correct the CRM 
statement and try again. 

DMREC 

NO DATA BASE ID FOR DATA MANAGER. 

At least one data base identifier must be 
specified on each active (ON) DMS statement. 

Add data base identifier 
to DMS statement(s) or 
specify status as OFF. 

TAF 

NO DATA BASE NAME IN xxJ FOR TOTAL. 

Self-explanatory. 

Add data base name to 
xxJ file. 

TAF 

NO DIRECTIVES. 

No directives were supplyed to DMREC. 

Supply the correct 
directives and rerun. 

DMREC 

NO DUMP RECORD WITH SPECIFIED VSN. 

DMREC could not locate a dump record with 
the specified VSN. 

Check directory with 
list directive for 
proper VSN. 

DMREC 

NO FILE NAME SPECIFIED ON CRM CARD. 

A CRM statement in the xxJ file did not 
contain a file name. 

Correct the xxJ file and 
try again. 

DMREC 

NO FILE NAME SPECIFIED ON IXN CARD. 

The xxJ file has an IXN statement that does 
not contain a file name. 

Correct IXN statement on 
xxJ file and rerun. 

DMREC 

(RXJ) 

NO FILES TO DUMP. 

No files have been specified on a dump 
directive. 

Include file name on 
directive. 

DMREC 

NO HOSE CONNECTED. 

YOU HAVE ENTERED A (ct)TM COMMAND WHEN 

THERE IS NO HOST CONNECTION. 

Enter (ct)HD to display 
host status and then 
enter <ct)HN=nn or =mm 
to connect to the 
selected host. 

RTN? 

NO HOST AVAILABLE CONTROL CHARACTER-char 
display 

ENTER char HD TO SEE HOST STATUS 

No hosts are available. 

display The host availability 

display (HAD), which 
appears if you have enabled 
it using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

Check the status of 
the hosts in your 
configuration. 

CCP 

NO HOST CONNECTED CONTROL CHARACTER=char 
display 

ENTER INPUT TO CONNEa TO HOST 

You have attempted to disconnect your 
terminal from a host when you have no 
connection to a host. 

display The host availability 

display (HAD), which only 
appears if you have enabled 
it using the HD terminal 
definition command. 

Enter a HD terminal 
defintion command to 
determine the status of 
hosts in the system, or 
enter any input to 
initiate your connection 
to the host. 

CCP 

NO HOST SELECTED CONTROL CHARACTERschar 

display 

ENTER char KN^NODE NUMBER or 

KS=NAM£ TO SELEQ HOST 

You have not selected a host and a host is 
available. 

display The host availability 

display (HAD), which 
appears if you have enabled 
it using the HD terminal 
definition command, 
char The network control 

character for your terminal. 

Select a host. 

CCP 

NO KEY LENGTH SPECIFIED ON CRM CARD. 

The KL parameter on the CRM statement was 
not specified. 

Correct the CRM 
statement and try again. 

DMREC 

NO MAXIMUM RECORD LENGTH SPECIFIED ON THE 

CRM CARD. 

The MRL parameter on the CRM statement was 
not specified. 

Correct the CRM 
statement and try again. 

DMREC 

NO RECORD FOUND FOR GIVEN VSN - DATE/TIME. 

The file specified or implied on the load 
cannot be found on the directory. 

Check load directive for 
correct file loading 
parameters. 

DMREC 

NO SPACE FOR ARF/BRF BUFFER. 

No space was available for an ARF or BRF 
buffer. 

Increase field length of 
DMREC. 

DMREC 
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SIGNIFICANCE 
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NO TERMINALS IN NETWORK FILE - filename. 

A valid network file was found but no 
transaction terminals were defined in it. 

Ensure the network file 
is correctly named. The 
network file is NCTFi 

Ci=id specified on 
network directive in 

TCF). 

TAFREC 

NO TRANSACTION NAME IS DEFINED IN TASK 
LIBRARY. 

No named transaction appears in any task 
library. 

If appropriate, define 
named transactions. 

TAF 

NOT ALL DATA BASE FILES UPPED. 

CRMTASK issued a DBUP request but AAMI was 
unable to attach/open all of the data base 
files. 

Inform data base 
administrator. 

CRMTASK 

NOT AVAILABLE. 

K display message indicating that the entry 
is not available for this version. 

None. 

TAF 

fUename NOT FOUND. 

The user specified the P option on the 

KTSDMP command; one of the two files was 
not in the user's permanent file catalog or 
a PFM error occurred. 

Specify a different file 
name or inform a site 
analyst. 

KTSDMP 

xxxxxxx NOT FOUND IN DIRECTORY. 

Specified file is not found in the 
directory. 

Check the file name and 
the list directory. 

DMREC 

xxxxxxx NOT IN DIRECTORY. 

Error - The task or named TAF transaction 
unit, xxxxxxx, was specified in the TN 
parameter but was not found on the task 
library or transaction unit directory. 

Ensure the correct task 
or transaction name was 
specified with the TN 
parameter. Check task 
or transaction listing 
for presence of 
specified unit. 

TAF 

xxxxxx NOT INITIALIZED BY TOTAL. 

STATUS IS yyyy. 

An error was encountered on the TOTAL data 
base. 

Regenerate TOTAL data 
base. Refer to TOTAL 
Reference Manual for 
status. 

TAF 

NOTE FAILURE, THEN TYPE IN CFO, JSN. GO. 

An error occurred that requires operator 
notification. 

The operator should log 
the failure, or notify 
the data base 
administrator and/or 
correct as directed, if 
the error was not 
recovered by DMREC. 

DMREC 

NUa DESCRIPTION FILE. 

Self-explanatory. 

Create a description 
file (NCTFi where i is 
the machine identifier 
specified on the network 
statement in the TCF). 

TAF 

OFF TASK taskname-LIBRARY librarynaaie. 

Task taskname in task library libraryname 
could not be loaded from extended memory or 
recovered and loaded from mass storage. 

Task was turned off. TAF transactions 
using tasks will abort. 

Inform site analyst. 

Library must be 
recreated. 

TAF 

ONLY *BLOCK* or ^RECORD* CAN FOLLOW FILE 

NAME. 

Self-explanatory. 

Correct error and rerun. 

DMREC 

OPEN ERROR ON COPY OF THE DIRECTORY. 

An open error was generated when trying to 
access the directory file. 

Inform data 
administrator. 

DMREC 

OPERATOR OVERRIDE. 

Operator has overridden TAF. 

None. 

TAF 

OPERATOR TERMINATION. 

Operator typed in K.STOP in K display 
command. 

None. 

TAFREC 

PACKED DATE/TIME CONVERSION ERROR. 

An error was generated when converting the 
directive date/time to a packed date/time. 

Check the date and time 
used on directive and 
rerun. 

DMREC 

PARAMETER FORMAT ERROR. 

The input directive contains an incorrect 
file name - too many characters or 
nonalphanumeric characters. 

Correct directive and 
rerun. 

DMREC 

PARITY ERROR IN TAPE WITH VSN=vsn. 

Tape with vsn has been mounted and has a 
parity error. 

Clean the tape or 
replace it. 

DMREC 

nnnn PER CENT CPU USAGE. 

Summary message indicating CPU usage by the 
transaction subsystem. 

None. 

TAF 

PERCENT PARAMETER NOT SPECIFIED PROPERLY. 

The percent parameter was not of the 
correct format or was specified greater 
than 100, 

Correct directive and 
rerun. 

DMREC 

PF xxxxxxx - NOT ON xxj FILE. 

The XXJ file does not have the specified 

CRM data file defined. 

Make necessary xxJ fiLe 
entry (CRM statement). 

DMREC 

(RXJ) 
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SIGNIFICANCE 


ACT ION 
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PF xxxxxxx - READ ONLY. 

POSSIBLE BLOCKAGE AMONG CM RESIDENT TASKS. 


POTENTIALLY BLOCKED TASKS DETECTED. 

RA+1 CALL ERROR. 

RA't^l CALL PARAMETER ADDRESS OUTSIDE FL. 
RA+1 CALL WITH ILLEGAL FUNCTION CODE. 

READ ERROR ON TAPE. 

READ/WRITE ERROR ON TAPE. 


V RECORD NUMBER ERROR. 


XX - RECOVERABLE DATA BASE. 

RECOVERABLE FILE PARAMETER MUST BE *R« OR 
*N* 

RECOVERABLE RUN UNIT DELETED - usernane. 


RECOVERY COMPLETE. 


RECOVERY FILE INCONSISTENT 


RECOVERY FILE INITIALIZATION ERROR 



RECOVERY IMPOSSIBLE. 


RECOVERY NOT POSSIBLE NOW BECAUSE DATA BASE 
FILE IS DOWN. SELECT DESIRED OPTION FROM 
FOLLOWING LIST BY ENTERING LETTER. 

A WAH 5 MINUTES AND TRY AGAIN. TAF 
WILL WAIT 5 MINUTES BEFORE 
ATTEMPTING RERUN OF TRANSACTION. 

B LOG OFF. THE PREVIOUS RECOVERABLE 

INFORMATION WILL REMAIN INTACT. LOG 
IN AT A LATER TIME TO ATTEMPT RERUN, 


An attetnpt has been made to write on a file 
defined in the xxJ file as read only. 

The sun of the maximua field Lengths (MFLs) 
for the CM resident tasks exceeds the 
oiinimun size of the total task area 
(potential space available to contain 
tasks). Thus one or more CM resident tasks 
could be blocked from completing. 

During TAF initialization, potentially 
blocked tasks were detected. Preceding 
error messages contain additional details. 

There was an unrecognizable task request. 


A parameter in a task request was outside 
the field length of the task. 

There was an unrecognizable task request 
for system action. 

Error in attempting to read an after image 
dump tape. 

A tape error has been encountered. If 
possible, use another tape. 


No header or an incorrect header or a 
missing header has been found on an ARF 
when updating a file. 

TAF/CRM is beginning task recovery process 
for recoverable data base xx. 

The recovery parameter of the *CRM* 
statement in the ♦xxJ* file is incorrect. 

The recoverable run unit for username which 
appeared on the CRF has been deleted 
because username did not appear in the 
corresponding NCTFi file. 

The transaction executive or interactive 
subsystem has successfully completed 
recovery. 

The ARF or BRF table header information 
does not match the buffer header 
information. 


An error has occurred during initialization 
because of the ARF or BRF file. 


A fatal error occurred during transaction 
executive initialization or the recovery 
file prepared by the TAF initialization 
routine does not exist or could not be read. 

Self-explanatory. 


Change the xxJ file 
access mode. 

Correct error. 


Correct error. 


Correct task or inform 
data base administrator. 

Correct task or inform 
data base administrator. 

Correct task or inform 
data base administrator. 

Inform the data 
administrator. 

On all dumps, use 
another tape; on other 
DHREC functions, inform 
data administrator. 

Inform data 
administrator. 


None. 


Fix the *CRM* statement. 


None. 


None. 


Dump the database 
associated with the 
inconsistent ARF or 
BRF using DMREC. 
Re-create the ARF or 
BRF using DMREC and 
reinitialize the 
transaction subsystem. 

Refer to the error 
message following this 
one for the error 
condition description. 

Check dayfile for a 
specific error message 
or inform the site 
analyst. 

Inform data base 
administrator. The data 
base file must be 
brought up for recovery. 


C ALLOW ENTRY OF NEXT TRANSACTION. 

THE PREVIOUS RECOVERABLE INFORMATION 
WILL BE LOST. 


DMREC 

TAF 


TAF 

MSABT 

MSA6T 

MSABT 

DMREC 

DMREC 

DMREC 

AAMI 

DRMEC 

TAFREC 

TAF 

lAFEX 

TAF1 


AAMI 


TAF 


RTASK 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

RECOVERY, RERUNNING TRANSACTION. 

The last entered TAF transaction input 
caused TAF a rerunnable transaction to be 
executed. A failure occurred before the 
completion of the transaction and the 
transaction executive is rerunning the 
transaction. 

Wait for TAF transaction 
output. 

RTASK 

RECOVERY, TRANSACTION NOT RERUNNABL£, ENTER 
NEXT TRANSACTION. 

An input/output error in the TRF caused 
loss of recovery data and the system cannot 
restart the TAF transaction automatically. 

Inform the data 
adninistrator or the 
transaction 

administrator. The data 
base may or may not have 
been committed. Do not 
rerun the TAF 
transaction until the 
state of the data base 
can be determined. 

RTASK 

REFERENCE MADE TO INCORRECT TERMINAL NAME. 

The terminal name or user name specified 
has not been defined. 

Correct task or inform 
data base administrator. 

MSABT 

REPEAT.. 

Data will now be accepted by the network. 

None. 

CCP 

REQUEST COMPLETE. 

The terminal origin CRMTASK request is 
complete. 

None. 

CRMTASK 

REQUESTED ECS NOT AVAILABLE. 

The amount of extended memory requested was 
not available in a contiguous block. 

Reinitialize with less 
extended memory 
requested. 

TAF 

SEND TO TERMINAL NOT LOGGED IN. 

A terminal issued a SEND without recall and 
one of the following occurred. 

* TAF was not connected to NAM. 

* The terminal to which the SEND was 
attempted was not logged into TAF. 

- TAF received a STOP supervisory message 
for the destination terminal. 

Correct error condition 
or inform data base 
administrator. 

MSABT 

SSF FIMCTION nn RECEIVED ERROR mm FOR 

Z2ZZZZZ. 

TAF received error code mm (octal) while 
issuing SSF function code nn (octal) for 
job ZZZZ2ZZ. 

Inform TAF site analyst. 

TAF 

SYSTEM ABORT OF TASK. 

The operator aborted the task (via a K.DROP 
or K.ODROP command), or a data manager 
error caused the task to abort. 

Inform data base 
administrator. 

MSABT 

SYSTEM TASK LIBRARY MISSING TASK, taskname. 

Taskname is not on system library or not 
enough communication blocks are allocated. 

Add taskname to system 
library or increase 
number of communication 
blocks. 

TAF 

TABLE OVERFLOW-TOO MANY TASKS. 

The managed tables used by LIBTASK are not 
large enough for the number of tasks or 
directives. 

LIBTASK must be 
reassembled with larger 
table allocation. 

LIBTASK 

TAF COMMUNICATIONS RECOVERY FILE NOT FOUND 
- filename. 

The recovery file could not be found. 

- Check that the 
correct familyname 
and user name were 
specified on NETWORK 
statement. 

Check if TRFi should 
be initiaized via 

K.INT initial K 
display command. 

TAFREC 

TAF/CRM CRM STATUS nnnnB IN FUNCTION 

yyyyyyy - 

A CRM status error occurred on a TAF/CRM 
request. 

Check AAM reference 
manual for meaning of 
the status code and 
correct error. 

8AAML 

TAF/CRM DATA MANAGER NOT LOADED IN TAF. 

This message is returned to the dayfile of 
a batch concurrency job that attempted to 
access a CRM file while CRM was not loaded 
in TAF. 

Ask the data base 
analyst to bring up TAF 
with CRM. Rerun job 
when TAF/CRM is 
available. 

BAAML 

TAF/CRM FUNCTION CODE NOT VALID. 

TAF/CRM cannot process the request issued 
because it is an unrecognizable function 
code. This is an internal error. 

Inform data base 
administrator. 

BA AML 

TAF/CRM TAF status nnn IN FUNCTION yyyyyyy. 

A TAF status error occurred on a TAF/CRM 
request. 

Check TAF/CRM reference 
m^ual for meaning of 
status code and correct 
error. 

BAAML 

TAF DATA NOT WITHIN UCP FL. 

TAF cannot access data from user program 
because the address specified Is outside 
the user control point field length. 

Correct program. 

BAAML 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

TAF ERROR CODE NOT DEFINED. 

TAF or TAF/CRM has returned an error code 
that the routine RQS was not programmed to 
handle. 

Inform responsible 
individual for 
maintaining system. 

BAAML 

TAF FUNCTION CODE NOT VALID. 

TAF cannot process the request issued 
because it is an unrecognizable function 
code. This is an internal error. 

Inform data base 
administrator. 

8AAML 

TAF IDLE. 

Informative message. This message appears 
only on the B display when TAF is idle. 

None. 

TAF 

TAF IDLE (GO OR DROP). 

Access to TAF denied because it is idling 
down. 

Operator: Type 60,jsn. 
or drop job with 

OROP,jsn. Others: 
Informative message only. 

BAAML 

TAF IDLING DOWN. 

TAF is idling down only EX.LOGT will be 
accepted by TAF. 

Log off by typing 

EX.LOGT. 

ITASK 

TAF INTERNAL ERROR. 

TAF has found internal data to be 
inconsistent. 

Perform a dump of TAF or 
inform site analyst. 

TAF 

TAF NOT PRESENT (GO OR DROP). 

The TAF subsystem was not present when a 
batch job tried to connect to it. 

Operator: Bring up TAF 
and type GO.jsn. or drop 
job with 0R0P,jsn. 

Others: Informative 

message only. 

BAAML 

TAF RECOVERY REQUEST ERROR. 

TAP cannot recover a batch user because of 
an internal TSTAT error. 

Inform data base 
administrator. 

BAAML 

TAF SUBSYSTEM NOT DEFINED AS A SCP 

TAF was not defined as a system control 
point when it was brought up. 

Inform data base 
administrator. 

BAAML 

TAF TERMINATE. 

The transaction subsystem was dropped via 

OSD command IDLE,TAF and was not restarted. 

None. 

TAF 

TAF 

TAF TRANSACTION NAME UNKNOWN. 

The transaction name requested for 
scheduling was not found in either the data 
base or system task library in TAF. 

Enter correct 
transaction name or 
define the unknown 
transaction name in the 
task library or check to 
see whether nonexistent 
tasks are defined in the 
transaction. 

MSABT 

TAF TRANSACTION NOT RERUNNABLE. 

There was an attempt to rerun a transaction 
and an error occurred. 

Inform the data 
administrator. The 
adainistrator may check 
the TAF dayfile for the 
possible cause of the 
error. 

RTASK 

TAF TWO OUTSTANDING REQUESTS. 

TAF received another request from a user 
program before the previous request was 
satisfied. This is an internal error. 

Inform data base 
administrator. 

BAAML 

TAF USER NOT VALID FOR TAF ACCESS. 

The batch job tried to access TAF (via a 
BTRAN) and the user name under which the 
job was run was not validated in the 
network file of TAF. 

Inform TAF data 
adninistrator to enter 
the user name in the 
network file of TAF. 

BAAML 

TAF 

TAF USER NUMBER ACTIVE. 

Another batch or terminal job is currently 
accessing TAF/CRM under this user name. 

Resubmit job at a later 
time. 

BAAML 

TAPE NOT READABLE. 

On a record load of a file the dump tape 
was found incomplete ' no trailer record. 

Load from previous dump. 

DMREC 

TASK CEASE WITH REQUESTED ABORTED. 

The task requested on abnormal CEASE with 
or without memory dump. 

Inform data base 
administrator. 

MSABT 

TASK EDITING COMPLETE. 

Dayfile message indicating that the run has 
terminated. Normal LIBTASK output consists 
of four lists - the input directives, the 
tasks on the current library, the tasks 
added to the library, and the tasks 
replaced on the library. After these lists, 
the time and date of the last library 
modification are given. If errors occurred 
during processing of the task binary file, 
a list of error messages also appears. If 
the LIBTASK run was initiated from a 
terminal, the directive and current library 
lists do not appear. 

Refer to next dayfile 
message. 

LIBTASK 

TASK LIBRARY DIRECTORY EMPTY. 

The last record of the library file is 
empty. 

Ensure that the correct 
file has been specified; 
if so, the library must 
be recreated. 

LIBTASK 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

TASK LIBRARY DIRECTORY EMPTY - 1Ibraryname. 

The file specified as the task library 
contains no recognizable directory. TAF 
aborts. 

Inform site analyst. 

Task library libraryname 
must be corrected and 

TAF reinitialized. 

TAF 

TASK LIBRARY DIRECTORY ERROR - libraryname. 

Task library libraryname contains no 
recognizable directory. TAF aborts. 

Inform site analyst. 

Task library must be 
corrected. 

TAF 

TASK LIBRARY DIRECTORY ERRORS. 

The first word of the last record on the 
library file does not contain the directory 
header. 

Correct and rerun. 

LIBTASK 

TASK LIBRARY DIRECTORY TOO LONG. 

The directory is too long for the buffer 
allocated. 

This may be altered by 
changing an assembly 
constant. 

LIBTASK 

TASK LIBRARY DIRECTORY TOO LONG - 
Libraryname. 

The length of the indicated task library 
directory exceeds the limit specified by 
the installation parameter TLDMT. 

Size of task library 
must be reduced or TAF 
and LIBTASK must be 
reassembled with TLDMT 
increased. 

TAF 

TASK NOT VALIDATED FOR REQUEST. 

One of the following actions has occurred. 

The terminal operator initiated a TAF 
transaction which tried to perform an 
action associated with a data base for 
which the terminal was not validated. 

A NEUTRAN request was issued by a task 
not in the system task library (TASKLIB). 

Perform the appropriate 
action. 

* Inform the data 
administrator. Set 
up the terminal 
name in the network 
file to use the data 
base. The system 
data base (SY) may be 
used. 

- Put the task on 

TASKLIB. 

MS AST 

taskname - TASK RECOVERED. 

The specified task has been recovered. 

None. 

AAMl 

taskname - TASK RECOVERY FAILED. 

The specified task recovery attempt has 
failed. 

Inform data 
administrator. 

AAMI 

TASK REQUEST ARGUMENT ERROR. 

A parameter error occurred in a request. 

Correct task or inform 
data base administrator. 

MSABT 

TASK REQUESTED CEASE BEFORE DM FINISHED. 

The task requested to end before the data 
manager completed all outstanding requests. 

Correct task or inform 
data base administrator. 

MSABT 

TASK TIME LIMCT. 

The task exceeded n time slices. The 
length of the time slice is set by an 
installation parameter. The nunber of time 
slices^ n, allowed for the execution of a 
task can be changed with a task ITL request. 

Increase time slices or 
inform data base 
administrator. 

MSABT 

nnn TASKS NOT LOADED INTO ECS. 

An insufficient amount of extended memory 
was available to load all tasks. The nnn 
field is the nunber of tasks not loaded. 

Check extended memory 
requested and 
reinitialize with more 
extended memory if 
appropriate. 

TAF 

TERMINAL DISABLED BY NOP. 

The network operator has disabled your 
terminal. No further input is possible. 

None. 

CCP 

TERMINAL NOT AVAILABLE. 

An interactive user has attempted to login 
with recovery outstanding on a batch 
concurrency or 9TRAN user 

Recover the batch 
concurrency or BTRAN 
user. 

RTASK 

TERMINAL TIMEOUT^ OPTION B ASSUMED. 

Self-explanatory. 

None. 

RTASK 

TERMINATION IN PROGRESS. 

The interactive subsystem has begun 
dunp/disconnect/recovery procedures due to 
an abort or termination condition. 

None* 

TAF 

lAFEX 

TLD OVERFLOW. 

Space is reserved at initialization to 
dynamically add tasks to the TAF resident 
copy of each task directory. The nunber of 
tasks is limited (default is 10) by the 
installation parameter TLDL. This message 
indicates that more tasks than allowed have 
been added since the most recent TAF 
initialization. The extra tasks will be 
ignored by TAF until it is reinitialized. 

None. 

TAF 

TN REQUIRES EITHER LO=T OR LO=X. 

The TN parameter was specified on the 

LIBTASK command without a corresponding 

LOST or L0=X parameter. 

Specify correct 
combination of list 
option parameters. 

LIBTASK 

TOO MANY BRANCHES IN TASK CHAIN REQUESTED. 

Only three branches are allowed in the task 
chain; more than three were requested. 

Correct task or inform 
data base administrator. 

MSABT 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


TOO MANY DATA BASE NAMES. 

The nimber of data base names associated 
with one data manager via DMS statements 
exceeds the value of MAXDB. 

Decrease the nunber of 
data base names 
associated with the data 
manager. 

TAF 

TOO MANY PILE NAMES OR VSN-S SPECIFIED. 

The VSN or file name limit was exceeded on 
a directive. 

Check the installation 
parameters TVSNL and 

TDFNL for maxifflums. 

DMREC 

TOO MANY FILES IN TOTAL DATA BASE. 

Self*explanatory. 

Reduce the number of 
entries in the TCF file 
or increase TMAXFIL. 

TAF 

TOO MANY NEW TRANSACTIONS ON TRANSACTION 
DIRECTORY •> filename. 

Informative message. During an on line 
update of a task library^ TAP detected that 
the transaction directory (TRD) was longer 
than allowed (the nusber of new additions 
exceeds installation parameter TRDMN). 

Excess named TAP transaction definitions 
will be discarded. 

None. When TAF is next 
initialized, the new 
transaction definitions 
will be included. 

TAF 

TOO MANY RA'^I CALLS. 

Only n monitor requests are allowed; more 
than n occurred^ where n is an assembly 
constant. 

Inform site analyst. 
Possibly a task is in a 
loop. 

MSABT 

TOO MANY TAP JOURNAL FILES IN xxj FILE. 

More than three TAF journal files per data 
base were specified, causing the 
transaction subsystem to abort. 

Examine xxJ file for 
xxJOR entries. Inform 
the TAF data 
administrator. 

TAF 

TOTAL DATA MANAGER NOT LOADED. 

TOTAL data manager was called but has not 
been loaded. 

Inform data base 
administrator. 

MSABT 

TOTAL DATA MANAGER SUCCESSFULLY LOADED. 

Self-explanatory. 

None. 

TAF 

TOTAL DID NOT RECOVER PROPERLY 

An error status yyyy was returned on a 

Correct error and 

TAF 

STATUS IS yyyy- 

TOTAL FINAL call. Refer to Diagnostics in 
the TOTAL Reference Manual for yyyy. 

reinitialize transaction 
executive. 

TAF 

TRAN. SEO. zzzzzzzzB with ID xxxxx MIGHT BE 

A BRF disk error has occurred and the 

Inform data base 

DMREC 

BAD. 

transaction sequence nusbers listed in the 
dayfile might contain errors. 

administrator of the 
error. 

REC 

TRANSACTION DIRECTORY EMPTY. 

Probable corruption of task library file. 

Regenerate task library. 

LIBTASK 

TRANSACTION DIRECTORY EMPTY - filename. 

Probable corruption of task library file. 

Regenerate task library. 

TAF 

TRANSACTION DIRECTORY ERROR. 

Probable corruption of task library file. 

Regenerate task library. 

LIBTASK 

TRANSACTION DIRECTORY ERROR - filename. 

Probable corruption of task library file. 

Regenerate task library. 

TAF 

TRANSACTION DIRECTORY TOO LONG - filename. 

Error — Too many transaction definitions 
exist in the transaction directory. 

Regenerate task 
library. Make sure the 
nusber of transactions 
does not exceed 
installation parameter 

TROMT or reassemble TAF 
and LIBTASK increasing 
the size of the 
installation parameter 
TRDMT. 

LIBTASK 

TRANSACTION DIRECTORY TOO LONG. 

Too many transactions exist in 
named-transaction directory. 

Either reduce nunber of 
named-transactions 
declared or contact TAF 
site analyst. 

LIBTASK 

TRANSACTION SESSION ENDED. 

Option B was selected and TAF logged the 
terminal off leaving the previous 
recoverable informaton intact. 

Log in at a Later time 
to attempt rerun. 

RTASK 

TT OPTION REQUIRES USER NUMBER. 

When updating a task library on-line (TT 
option is specified on LIBTASK command), 
the user name must be specified prior to 
the LIBTASK command so the library 
associated with that user name can be found. 

Specify user name via 

USER or CHARGE command 
before LIBTASK command 
and rerun job. 

LIBTASK 

UN=username NOT VALID ON FM=family. 

Username on the specified familyname is 
not valid. The user name and familyname 
may not be defined or are incorrect in xxJ 
fi le. 

Inform site analyst. 

TAF 

UNABLE TO ATTACH TOTAL BINARIES. 

File of TOTAL binaries is not under the 
user index of the transaction subsystem or 
a PFM error occurred. 

Correct error and 
reinitialize transaction 
executive, or inform 
site analyst. 

TAF 
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MESSAGE 

SIGNIFICANCE 

ACTION 

ROUTINE 

UNABLE TO ATTACH TOTAL OGMOD BINARIES. 

One or more of the DBMOD files Listed on 
the TOTAL DMS statement in the TCF file 
could not be attached under the user name 
of the transaction subsystem or a PFM error 
occurred. 

Correct error and 
reinitialize transaction 
executive/ or inform 
site analyst. 

TAF 

UNKNOWN FILE FORMAT. 

There is a logical error in the structure 
of the input file. It does not conform to 
the established format rules. 

None. 

KTSDMP 

UNKNOWN NAMED TRANSACTION UNIT REQUESTED FOR 
SCHEDULING. 

The transaction name requested for 
scheduling was incorrect. 

Enter the correct 
transaction name. 

IT ASK 

UNRECOGNIZABLE CIO ERROR CODE. 

Self-explanatory. 

Inform site analyst. 

TAF 

UNRECOGNIZABLE HEADER TYPE. 

When interpreting ARF after image header 
types^ one has been found incorrect. 

Inform data 
administrator. 

DMREC 

USER STATEMENT DOES NOT APPEAR IN TCF. 

Self-explanatory. 

Add a USER statement to 
the TCF. 

TAFREC 

USER STATEMENT NOT VALID ON FAMILY. 

The user name specified by the USER 
statement is not valid on the family. 

Validate user on 
specified family or 
correct USER statement. 

TAFREC 

VALID LO OPTIONS ARE LO^ LO=A, LO=T or LO=X. 

The LO parameter was specified on the 

LIBTASK command with an incorrect list 
option. 

Specify one of the 
following valid list 
options LO/ L0=A/ L0=T 
or L0=X, 

LIBTASK 

VALID OPTIONS ARE A^ B, OR C. 

The option entered was not A^ B, or C. 

Reenter a valid option. 

RTASK 

cmd VALUE INAPPROPRIATE 

The value you specified in the terminal 
definition command cmd is not appropriate 
for your terminal. 

Choose an appropriate 
value (refer to appendix 

J). 

CCP 

V5N ALREADY EXISTS. 

When attempting to use the edit/add 
directives^ the VSN specified was found to 
already exist on the directory. 

Continue processing. 

DMREC 

VSN - xxxxxx ALREADY IN DIRECTORY. 

The VSN supplied for this operation was 
found to already exist on the directory. 

Try another VSN, 

DMREC 

VSN AND DATE/TIME CANNOT CO-EXIST ON LOAD 
DIRECTIVE. 

On a load directive the date/time keywords 
cannot be used with VSN keyword. 

Correct the directive 
and rerun. 

DMREC 

VSN ASSIGNED DOES NOT MATCH VSN REQUESTED. 

The VSN assigned as a result of a DMREC ADO 
subdirective does not agree with the VSN 
specified on the subdirective. 

Correct the VSN conflict. 

DMREC 

VSN DOES NOT EXIST. 

When attempting to access a directory/ the 
specified VSN was not found on the 
directory. 

List the directory for 
further information. 

DMREC 

VSN IS NOT FIRST REEL. 

When attempting to modify a directory/ the 
specified VSN was not the first reel of the 
set. 

Specify the first reel 
of the multireel set. 

DMREC 

VSN OR DATE/TIME NOT SPECIFIED. 

When attempting to delete directory 
entries/ no VSN or date/time was specified. 

Specify VSN or date/time 
and rerun. 

DMREC 

VSN TABLE OVERFLOW. 

Too many VSN entries were encountered for 
this directive. 

Check directive and 
increase TVSN size if 
necessary. 

DMREC 

(BVT) 

WAH.. 

The network is unable to accept any further 
data from your terminal. Data that was 
entered is discarded. This is normally a 
temporary situation caused by buffer 
shortages in the host or the network. 

Wait for the REPEAT,, 
message. 

CCP 

WAITING 

Option A was selected and TAF will wait 5 
minutes before attempting a rerun of the 
transaction. 

None. 

RTASK 

WAITINP FROM MULTI QUEUED TASK. 

A WAITINP request was issued by a task that 
was scheduled to process more than one TAF 
transaction or by a task that was called 
with return. 

Correct task or inform 
data base administrator. 

MSABT 

WRONG ENTRY WHILE READING VSN ENTRIES. 

The VSN record read from the directory has 
an incorrect format. 

Inform data 
administrator. 

DMREC 

WRONG VSN USED. 

Either the wrong VSN was used or no header 
was found on ARF. 

Make sure the correct 

ARF is being used and 
retry. 

DMREC 

ZZdbAnn - ACTIVE ARF. 

File ZZdbAnn is the active image recovery 
file for data base db. 

Informative message. 

AAMI 
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MESSAGE 


SIGNIFICANCE 


ACTION 


ROUTINE 


ZZdbBnn - 8RF RECOVERY 
FILE. 


ZZdbDIR UNREADABLE. 


TAF/CRH is beginning to roll back data base 
updates from file ZZdbBnn, 


File name entry can be 
restored by adding an 
appropriate CRM 
statement to the xxJ 
fi Le. 


When trying to expand a data file, an. Inform data 

attempt to read the directory file failed. administrator. 


AAMI 


DMREC 
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GLOSSARY 


C 


AAM 

Refer to Advanced Access Methods. 

ABH 

Refer to Application Block Header. 

ABN 

Refer to Application Block Number. 

Absolute code 

Code in which all required external references 
have been satisfied. All addresses refer to 
specific locations within the job field length. 

ABT 

Refer to Application Block Type. 

ACN 

Refer to Application Connection Number. 

ACT 

Refer to Application Character Type. 

Actual Key 

The primary key for a record in a file with 
actual key organization; Indicates the storage 
location of the record. 

Actual Key (AK) File 

A mass storage file in which each record is 
stored at the location indicated by the primary 
key. For initial actual key files, the primary 
key must specify the block and record slot number 
in which the record is stored. For extended 
actual key files, the primary key is a record 
number that AAM converts to the storage location 
of the record. Access is random or sequential. 

Address 

The location of a word in memory. The location 
is designated by number or symbolic name. 

Advanced Access Methods (AAM) 

A file manager that processes indexed sequential, 
direct access, and actual key file organizations, 
and supports the Multiple Index Processor. Refer 
to CYBER Record Manager. 

After Image 

A copy of a DMS-170 data base record after it 
has been modified. 


After Image Recovery File (ARF) 

A file upon which TAF writes after images of 
records in recoverable files when a request to 
update such a record is processed within a 
begin-commit sequence. 

AK File 

Refer to Actual Key File. 

Alias 

A data name used in a subschema in place of a 
schema data name. 

Alphabetic Character 

A character belonging to the set of letters A 
through Z and the space. 

Alphanumeric 

Consisting of alphabetic and/or numeric 
characters only. 

Alternate Key 

A key, other than the primary key, by which an 
indexed sequential, direct access', or actual key 
file can be accessed. 

ANSI 

American National Standards Institute* An 
organization that establishes standards for the 
benefit of its member organizations. 

Application 

In TAF, a set of data files and the set of tasks 
associated with those files. 

Application 

A program resident in a host computer that 
provides an information storage, retrieval, 
and/or processing service to a remote user via 
the data communication network. lAF is an 
example of an application. 

Application Block Header (ABH) 

A single 60-*bit word description accompanying 
every block passing between an application and 
NAM. 

Application Block Number (ABN) 

A field in the application block header. An 
application-*assigned number used to identify a 
particular data message block. 
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Application Block Type (ABT) 

A field in the application block header defining 
the accompanying block as either data or 
supervisory, null or not null, and indicating if 
this is the last block of a message. 

Application Character Type (ACT) 

A field in the application block header defining 
the byte size of text characters* 

Application Connection Nunber (ACN) 

A number assigned by the communications 
supervisor program to identify a particular 
logical connection within an application. 

Application Switching 

The process of leaving the control of one 
application and entering the control of another, 
without going through another complete login 
sequence. 

Area 

A uniquely named DMS-iyO data base subdivision 
that contains data records; a file. 

ARF 

Refer to After Image Recovery File. 

ASCII 

Anerican National Standard Code for Information 
Interchange. The standard character set and 
code used for Information Interchange between 
systems. 

ASCII Mode 

Use of the Aaerlcan National Standard Code for 
Information Interchange; a 128-character set. 
It includes both uppercase and lowercase letters. 


Assemble 

To transform a COMPASS language program into a 
form that the computer can execute directly. 
During assembly, machine language operation 
codes are substituted for CCMPASS codes and 
machine addresses for symbolic addresses. 
COMPASS performs the assembly. 

Attach 

The process of making a permanent file 
accessible to a job by specifying the proper 
permanent file identification and passwords. 

Auto Mode 

Mode of entering Information into a primary file 
where the system automatically generates line 
numbers. This allows you to correct, Insert, 
and delete lines easily because you can 
reference each line by Its line number. 

Automatic Login 

The process whereby one or more of the Network 
Validation Facility login dialog parameters is 


supplied to NVF from the local configuration 
file. Parameters supplied through automatic log¬ 
in configuration of a terminal suppress prompting 
for the corresponding dialog entries and override 
any entries made from the terminal. Automatic 
login is required for terminals (passive devices) 
incapable of conducting dialog with NVF. 

Backup Directory 

A direct access file automatically allocated and 
maintained by EMREC. It contains information 
about the data base, index and after image recov¬ 
ery files for an application. The file name is 
ZZxxDIR where xx is the application identifier* 

Backup Dump 

A copy of all or selected portions of a data 
base, which is produced on a regularly scheduled 
basis for the explicit purpose of data base 
recovery. 

Batch Job 

Instructions and data submitted as a complete 
unit without further user intervention. The job 
can be punched on cards or created and submitted 
from a terminal* 

Batch McKie 

The state of a mode 4A terminal during which 
batch data is transmitted from the terminal's 
card reader to central files and/or from central 
files to the terminal's line printer. Also, the 
state of an asynchronous terminal during which 
input transmission occurs on a block-by-block 
basis. 

Batch Test Facility 

An absolute program residing on the CDCS system 
library that allows CDCS to run at the same 
control point as a user program* 

Before Image 

A copy of a DMS-170 data base record before it 
has been modified. 

Before Image Recovery File (BRF) 

A file to vdiich TAF/CRM writes the before images 
of records in recoverable files when a request 
to read such a record is processed from within a 
begin-commit sequence. 

Begln-commlt sequence 

A series of data base updates beginning with a 
data base begin request and ending with a data 
base commit or data base free request. 

Beginning-of-Information (BOI) 

The start of the first user record in a file. 
Tape labels and system-supplied information, 
such as an index block or control word, do not 
affect beginning-of-information. 

Binary File 

Usually a noneditable file containing a pre¬ 
compiled program. 
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Bit 


An abbreviation of binary digit. It is a single 
digit, 0 or I, In a binary nuaber. Also used to 
represent the smallest unit of information. A 
central memory word (one storage location) 
contains 60 bits* 

Block 

In the context of network communications, a por¬ 
tion or all of a message. A message is divided 
into blocks to facilitate buffering, transmis¬ 
sion, error detection, and correction for vari¬ 
able length data streams. 

During input from a terminal, a block is a single 
transmission comprising one or more lines of one 
or more messages. 

During input to an application, a block is a 
single line comprising part or all of a message. 
Terminal transmission blocks are divided Into as 
many application Input blocks as needed to 
provide one block of Input per terminal input 
line, until the message is completed. 

During output to a terminal, a block is one or 
more lines comprising one message. 

BOI 

Refer to Beginning-of-Informatlon. 

BP 

Beginning Priority. 

BRF 

Refer to Before linage Recovery File. 

Called Task 

A task which Is the object of a CALLTSK or a 
CALLRTN request. 

Calling Task 

A task which executes a CALLSTK or a CALLRTN 
request. 

Carriage Control 

The control exercised over the format of printed 
output. The leftmost character of the data line 
to be printed is the carriage control character. 
Carriage control is also called format control. 


Communication Block. 

CCP 

Communications Control Program. 

CDCS 

Refer to CYBER Database Control System. 


Central Memory (CM) 

The main storage device whose storage cells 
(words) can be addressed by a computer program 
and from which Instructions and data can be 
loaded directly into registers from which the 
instructions can be executed or from which data 
can be manipulated. 


Character 

Any alphabetic, numeric, or special symbol that 
can be encoded. This term applies to the graphic 
characters for an input or output device, and to 
uniquely encoded control characters used by a 
terminal. Unless specified otherwise, characters 
are ASCII 8-bit byte characters. 


Charge Number 

An alphanoaerlc identifier the installation uses 
to allocate charges to individual users for 
system usage. 

CIO 

Circular Input/Output. 

Close 

A set of terminating operations performed on a 
file when input and output operations are 
complete. All files processed by the CYBER 
Record Manager must be closed. 

CM 

Refer to Central Memory. 

CMM 

Common Memory Manager. 

COBOL 

Common Business-Oriented Language. This higher 
level language simplifies the programming of 
business data applications. 


Command 

A sequence of words and characters that call a 
system routine to perform a job step. The com¬ 
mand must conform to format specifications and 
end with either a period or a right parenthesis. 
A command is sometimes called a control 
statement. 

Communication Recovery File (CRF) 

Files used for the automatic recovery feature. 
Compile 

To translate a program from a higher level pro¬ 
gramming language (for example, FORTRAN or BASIC) 
into machine instructions called object code. 
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Concurrency 

Simultaneous access to the same data in a data 
base by two or more applications during a given 
span of time* 

Console 

A terminal devoted to network control processing* 
There may be three such terminals: the network 
operator's (NOP) terminal, the local operator's 
(LOP) terminal, and the network processing unit 
console* 

CRF 

Refer to Communication Recovery File* 

CRM 

Refer to CYBER Record Manager* 

CRT 

Cathode Ray Tube. 

CYBER Database Control System (CDCS) 

The DMS-170 controlling module that provides the 
interface between an application and a data base* 

CYBER Loader 

The utility that prepares programs for execution 
by placing program Instruction and data blocks 
in central memory* 


CYBER Record Manager (CRM) 

A software product that allows a variety of 
record types, blocking types, and file organiza¬ 
tions to be created and accessed. Products like 
COBOL 5, FORTRAN Extended 4, FORTRAN 5, Sort/ 
Merge 4, Sort/Merge 5, ALGOL 5, and DMS 170 use 
the CYBER Record Manager to manage execution 
time Input/output* Neither the Input/output of 
the operating system nor that of most of the 
system utilities such as COPY or SKIPF is 
implemented through the CYBER Record Manager. 
All CYBER Record Manager file processing 
requests ultimately pass through the operating 
system input/output routines* 

DA 

Refer to Data Administrator* 

Data Administrator (DA) 

The individual who leads the design, 
programming, Implementation, and maintenance 
efforts associated with a DMS-170 controlled 
data base* 

Data Base 

A systematically organized, central pool of 
Information; organization is described by a 
specific schema* 


Data Base Status Block 

An area of memory defined within an application 
to which CDCS returns information concerning the 
status of operations on data base files and 
relations* The status block is updated after 
each CDCS operation* 

Data Block 

A block in which user records are stored in an 
indexed sequential or actual key file* Data 
block structure is defined by the user, or AAM 
defaults are accepted* Contrast with Index 
Block for indexed sequential files* 

Data Description Language (DDL) 

The language used to structure a DMS-170 schema 
and subschema. 

Data Management System 

Refer to Database Management System* 

Database Management System 

A generalized computer program which handles the 
mechanics of storing, updating, and accessing 
data for multiple applications* 

Dayfile 

A chronological file created during Job 
execution which forms a permanent accounting and 
Job history record* Dayfile messages are 
generated by operator action or when commands 
are processed* A copy of the dayfile is printed 
with the output for each Job* You must 
explicitly request it in an Interactive Job. 

DBREC 

Utility used to prepare files for transaction 
recovery using CDCS* 

DDL 

Refer to Data Description Language. 

Deadlock 

A situation that arises in concurrent data base 
access when two or more applications are contend¬ 
ing for a resource that is locked by one of the 
other ones, and none of the programs can proceed 
without that resource* 

Deadstart 

The process of initializing the system by 
loading the operating system library programs 
and any of the product set from magnetic tape or 
disk. Deadstart recovery is reinitialization 
after system failure* 

Default 

A system-supplied option used when you do not 
supply the option. 
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Delimiter 

A character used to separate statement elements, 
such as words and literal constants, or other 
strings of text. 

Device 

The physical recording medium of random mass 
storage, such as a disk pack. 

Device Set 

A group of rotating mass storage devices. No 
device can belong to more than one device set. 
Every file must be contained within one device 
set, but can be on different devices in that 
device set. 


Direct Access File 

A CYBER Record Manager file containing records 
stored randomly in home blocks according to the 
hashed value of the primary key in each record. 
Files must be mass storage-resident. All 
allocation for home blocks occurs when the file 
is opened on its creation run. Access is random 
or sequential. It may be attached to your job 
and all changes are made on the file itself 
rather than a temporary copy of the file. 


Directives 

The instructions that supplement processing 
defined by a command or by a program call for 
execution of a utility function or member of a 
product set. Directives do not appear in the 
command record; they are usually in a separate 
record of the file INPUT or a file referenced in 
a command. Directives are required for execution 
of FORM, the CREATE utility, and EDITLIB, among 
others. 

Disk 

A unit composed of one or more flat, circular 
plates with magnetic material on both sides that 
is used to store large amounts of data or 
programs. 

Display Code 

A 6-bit-display code set used to represent 
alphanumeric and special characters. 

Displays 

Two console screens or a split screen used to 
display system and job information, operator 
messages, and contents of central memory. 
Through the console keyboard, the operator can 
control the operation of the system. The 
displays are identified by alphabetic 
characters; some used frequently are: job status 
(B), system files (H), and dayfile messages (A). 

Dump 

A printed listing of the contents of the central 
processor registers and a predetermined number 
of words within central memory that pertain to a 
job. 


Dynamic Access 

Access mode that allows a nonsequential file on 
mass storage to be accessed randomly or 
sequentially, depending on the format of the 
access statement. 

ECS 

Refer to Extended Core Storage. 

End-of-File (EOF) 

A boundary within a sequential file, but not 
necessarily the end of a file, that can be 
referenced by name. The actual end of a named 
file is defined by EOI. For labeled tape, EOF 
and EOI (denoted by the EOFl label) are the 
same. For multifile tape files, EOF and EOI do 
not correspond. In the product set manuals, an 
end-of-file is also referred to as an 
end-of-partition. 

End- 0 f-Information (EOI) 

An indicator that marks the physical end of a 
named file. 

End-of-Record (EOR) 

The terminator of a logical record. On a PRU 
device, a short PRU or a zero-length PRU with a 
level designator of 0 indicates EOR. On tapes 
that are not PRU devices, an inter record gap 
indicates EOR. 

EOF 

Refer to End-of-File. 

EOI 

Refer to End-of-Information. 

EOR 

Refer to End-of-Record. 

ESM 

Extended Semiconductor Memory. 

Exchange Package 

A table Chat contains information used during 
job execution. It is printed as part of the 
output when a job aborts. 

Extended 

A terra used in conjunction with indexed sequen¬ 
tial, direct access, and actual key files to 
denote a specific type of Internal processing by 
AAM and MIP. Processing Is Indicated by setting 
the ORG FIT field to NEW. 

Extended Core Storage (ECS) 

Optional additional memory. ECS contains 60-blc 
words; it has a large amount of storage and fast 
transfer rates. ECS can be used only for program 
and data storage, not for program execution. 
Special hardware instructions exist for transfer¬ 
ring data between central memory and ECS. 
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Extended Memotry 

An extension to central memory which is physi¬ 
cally located outside of the machine. Formerly 
referred to as extended core storage (ECS) or 
large central memory (LCM). 

Family Name 

Name of the permanent file storage device or set 
of devices on which all of your permanent files 
are stored. When you request a permanent file, 
the system looks for It on this family (group) of 
devices. Usually a system has only one family 
of permanent file devices but it is possible to 
have alternate families in the system. You 
specify which family you are using when you log 
in. Your family name is given to you by your 
employer, instructor, or computer personnel. 

Fast Dynamic Loader (FDL) 

A facility that provides fast loading and 
unloading of specially formatted code called 
capsules. The amount of memory required for job 
execution can be greatly reduced because 
capsules can be easily loaded and unloaded as 
needed, freeing memory for other uses. 

FDL 

Refer to Fast Dynamic Loader. 

PE 

Refer to Format Effector. 

FET 

Refer to File Environment Table. 

Field Length (FL) 

The area in central memory allocated to a 
particular job; the only pact of central memory 
that a job can directly access. Also the number 
of central memory words required to process a 
job. 

File 

A collection of information referred to by a 
file name (from one through seven characters, 
either letters or numbers). You can create a 
file at the terminal or retrieve a file from 
permanent file storage for use during a terminal 
session. 

FILE Command 

A command that supplies file Information table 
values after a source language program is 
compiled or assembled but before the program is 
executed. Basic file characteristics such as 
organization, record type, and description can 
be specified in the FILE command. 

File Environment Table (FET) 

A table within a programme field length through 
which the program communicates with operating 
system input/output routines. One FET exists 
for each file in use by the program. 


File Information Table (FIT) 

A table through which a user program 
communicates with the CYBER Record Manager. For 
direct processing through CRM, a user must 
initiate establishment of this table. All file 
processing executes on the basis of information 
in this table. The user can sec FIT fields 
directly or use parameters in a file access call 
chat sets the fields Indirectly. Some product 
set members set the fields automatically for the 
user. 

File Organization 

Defined by ORGANIZATION clause. Can be sequen¬ 
tial, indexed, relative, direct, actual-key, or 
word-address. Established at the time Che file 
is created and cannot change as long as the file 
exists. Affects access mode, open mode, and for¬ 
mats of statements chat can be used to manipulate 
file records. 

File Statement 

Command for the CYBER Record Manager that 
specifies parameters for the FIT at the time the 
file is opened. 

File Statistics Table (FSTT) 

A table generated and maintained by the CYBER 
Record Manager to collect statistics about each 
direct access. Indexed sequential, and actual key 
file. The FSTT is a permanent part of a file 
and contains information such as organization 
type, size of blocks and the number of current 
accesses. 

FIT 

Refer to File Information Table. 

FL 

Refer to Field Length. 

Flag 

A character or bit that signals the occurrence 
or presence of a particular condition. 

FORM 

A general purpose file management utility for 
manipulating records and creating and converting 
files. 

Format Effector (FE) 

A control symbol used by certain protocols (for 
instance, the HASP protocol). 

FORTRAN 

FORmula TRANslation. A language that solves 
algebraic and scientific problems using symbols 
and statements that closely resemble 
mathematical notation. 

FSE 

Refer to Full Screen Editor. 
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FSTT 


Input 


Refer to File Statistics Table* 

Full Screen Editor 

The editing facility that enables you to edit 
files in a screen format or a line-by-line 
format* 

GTDL 

Global Task Dump Limit. 

HAD 

Host availability display* 

Hashing 

The method of using pritaary keys to search for 
relative home block addresses of records in a 
file with direct access storage structure* 

Header 

A word or set of words at the beginning of a 
block, record, file, or buffer which contains 
control information for that unit of data* 

Host 

A computer that executes applications* 
lAF 

Refer to Interactive Access Facility* 

Index 

In the context of AAM, a series of keys and 
pointers to records associated with the keys* 
The system creates an index for AAM files which 
relates alternate record keys to primary keys, 
using the file defined by the second 
implementor-name of an ASSIGN clause* 

In general context, a computer storage area or 
register, the content of which represents the 
identification of a particular element* 

Index Block 

For an indexed sequential file, a block with 
ordered keys and pointers to data blocks and 
other index blocks, forming a directory of the 
records within a file* 

Indexed Sequential (IS) File 

A file organization in which the CYBER Record 
Manager maintains records in sorted order by use 
of a programmer-defined key, which need not be 
within the record* Keys may be integer, floating 
point, or symbolic; access is random or sequen¬ 
tial* Files contain index blocks and data 
blocks* 

Indirect Access File 

A NOS permanent file that you access by making a 
temporary copy of the file (GET or OLD command)* 
You create or alter it by saving or substituting 
the contents of an existing temporary file 
(REPLACE or SAVE command). 


Information flowing upline from the terminal to 
the host computer* 

Interactive 

A mode of job processing in which the user 
enters a command or input to an executing 
program and receives an immediate response* 

Interactive Access Facility (lAF) 

An application that provides a terminal operator 
with the Interactive processing capability* The 
interactive facility makes terminal input/output 
and file input/output appear the same to an 
executing program* 

I/O 

Input/Output* 

IS File 

Refer to Indexed Sequential File* 

Itemize 

A utility routine that produces a listing of the 
contents of a file or library* 

IVT 

Interactive Virtual Terminal* 


All computer-related activity associated with a 
terminal session from login to logout* A batch 
job consists of instructions and data submitted 
as a complete unit* 

Key 

A group of contiguous characters or numbers the 
user defines to Identify a record in a CRM file* 


LOME 

Large Central Memory Extended* 


LDSET 

The loader directive used to control the load 
process under a variety of conditions* 


LGO 

The default name of the file to which language 
processors write executable code during program 
assembly or compilation* 

Load Sequence 

A sequence of load operations which encompasses 
all of the loader^s processing from the time that 
nothing is loaded until the time execution be¬ 
gins. It Includes initialization, specification 
of specified Loader requests, and the completion 
of the load* 
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Loader 


A software product that prepares programs for 
execution by placing program instructions and 
data blocks in central memory and linking 
references in the program to the appropriate 
external routines* 

Local 

Refers to data that exists only during the proc¬ 
essing of a single job and that can only be 
accessed by that job* 

Local Operator (LOP) 

The network operator who monitors line, terminal, 
and application activities in the network* 

Login 

The procedure used at an interactive terminal to 
gain access to the system* 

Logout 

The procedure by which you end terminal 
session* You type BYE* 

LOP 

Refer to Local Operator* 

Macro 

A sequence of source commands that are saved and 
then assembled whenever needed through a macro 
call. 

Mass Storage 

Magnetic disk or extended memory that can be 
accessed randomly as well as sequentially* 

Master Directory 

A file containing information used by CDCS in 
processing* This information consists of schema 
and subschema tables, media parameters, and data 
base procedure library and logging specifica¬ 
tions* 

MFL 

Maximum Field Length* 

MIP 

Refer to Multiple Index Processor* 

MP 

Maximum Priority* 

Multifile Set 

A tape file set having more than one tape file. 
Multimainframe Operation 

Operation that provides mechanisms by which more 
than one computer can share mass storage devices* 


Multiple Index File 

An Indexed sequential, direct access, or actual 
key file that has alternate keys defined* 

Multiple Index Processor (MIP) 

A processor that allows AAM files to be accessed 
by alternate keys* 

NAM 

Refer to Network Access Method* 

NCT 

Network Communication Table. 

NCTF 

Refer to Network Description File* 

NDL 

Refer to Network Definition Language* 

Network Access Method (NAM) 

A software package that provides a generalized 
method of using a communications network for 
switching, buffering, queuing, and transmitting 
data* NAM is a set of Interface routines used 
by a terminal servicing facility for shared 
access to a network of terminals and other 
applications, so that the facility program does 
not need to support the physical structures and 
protocols of a private communication network* 

Network Definition Language (NDL) 

The compiler-level language used to define the 
network configuration file and local config¬ 
uration file contents* 

Network Description File (NCTF) 

File that must be present if the transaction 
facility is used* The file is prepared by the 
site analyst* 


Network Operating System* 


Numeric Character 

Digits 0 through 9* 


Object Code 

The machine language version of a program that 
has been translated (compiled) from source code 
written in a higher level language. 


Open 

A set of preparatory operations performed on a 
file before input and output can take place; 
required for all CRM files* 
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operating System 

The set o£ system programs that controls the 
execution of computer programs and provides 
scheduling, error detection, input/output 
control, accounting, compilation, storage 
assignment, and other related services. 

Operation 

A particular function performed on units of 
data; for Instance, opening or closing an area, 
or storing or deleting a record. 

Order Dependent 

Used to describe Items which must appear In a 
specific order. 

Order Independent 

Used to describe Items which need not appear In 
any specific order. Parameters, particularly 
those with keywords, may be order Independent. 

Output 

Information flowing downline from host to 
terminal. 

Output File 

The file on which the system writes Information 
to the user. Unless another file name Is speci¬ 
fied, Che output file Is printed at the terminal. 

Pack Name 

A one- to seven-character name that Identifies 
the auxiliary device to be accessed In a 
permanent file request. 

Parameter 

A variable that is given a specific value for a 
particular purpose or process. 

Parity 

In writing data, an extra bit Is either set or 
cleared In each byte so that every byte has 
either an odd number of set bits (odd parity) or 
an even number of set bits (even parity). 
Parity is checked on a read for error detection 
and possible recovery. 

Password 

A name or word entered during login to provide 
extra security for your user name. A unique 
password ensures that no one else can log into 
Che system using your user name and access your 
files. 

Permanent File 

A file stored on mass storage. This file is 
cataloged by the system so chat its location and 
identification are always known to the system. 
Permanent files cannot be destroyed accidentally 
during normal system operation. They are 
protected by the system from unauthorized access 
according to privacy controls specified by Che 
file owner. 


Physical Record Unit (PRU) 

The amount of Information transmitted by a 
single physical operation of a specified 
device. For mass storage files, a PRU Is 64 

central memory words (640 characters); for 
magnetic tape files, the size of the PRU depends 

upon the tape format. A PRU that is not full of 

user data Is called a short PRO; a PRO that has 
a level terminator but no user data is called a 
zero-length PRU. 

Primary Key 

A key whose value uniquely identifies a record 
and determines the location of the record in a 
file. The primary key for a file must be 
defined when the file Is created and must be 

used to update the file. Contrast with Alternate 
Key. 

Procedure 

A user-defined set of Instructions that are 
referenced by name. The instructions consist of 
procedure directives and system commands. 

Procedure File 

A file containing one or more procedures. 

PRU 

Refer to Physical Record Unit. 

PSN 

Packet-Switching Network. 

Purge 

To delete a permanent file from the system. 
This enables releasing its mass storage space, 
erasing Its catalog entries, and so forth. 

Queue 

A sequence of blocks, tables, messages, and so 
forth. Most NPU queues are maintained by 

leaving the queued elements in place and using 

cables of pointers to the next queued element. 

Most queues operate on a first-ln, first-out 
basis. A series of workllst entries for a 

specific terminal Is an example of an NPU queue. 

RA 

Refer to Reference Address. 

RAE 

Refer to Reference Address. 

Record 

A unit of information. In the CYBER Record 
Manager and Its language processors, a record is 
a unit of information produced by a single read 
or write request. Eight different record types 
exist within CRM. The user defines the 
structure and characteristics of records within 
a file by declaring a record format. 

Other parts of the operating system and its 
products might have additional or different 
definitions of records. 
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Record Slot Number 

The position of a record vlthin a block In an 
actual key file; specified by the low-order bits 
of the primary key. 

Record Type 

The term record type can have one of several 
meanings, depending on the context. The CYBER 
Record Manager defines eight record types estab¬ 
lished by an RT field in the file information 
table. Tables output by the loader are classi¬ 
fied as record types such as text, relocatable, 
or absolute, depending on the first few words of 
the tables. 

Recovery 

A. process that makes a data base useful after 
some type of software or hardware failure has 
occurred. 

Reference Address (RA and RAE) 

RA is the absolute central memory address chat 
is the starting, or sero, relative address 
assigned to a program. Addresses within the 
program are relative to RA. RA+1 is used as the 
communication word between the user program and 
monitor* RAE is the absolute extended memory 
starting address assigned to Che file. 

Release System 

A software system delivered to a customer* In 
installing a system, the customer, but not an 
individual applications programmer, can use 
default values or parameters that differ from 
the released system* 

Relocatable Code 

Code that can be loaded into any region of the 
job field length* External references have not 
yet been satisfied. 

Request 

A statement that identifies a function to be 
performed* Often there are items used by or 
resulting from the function that are required as 
parameters in the request. 

Reserved Word 

An Identifier that has a predefined meaning to a 
compiler and must not appear In a source program 
as a user-defined word or name. 

Restart Identifier Pile 

Random permanent file used for a start 
Identifier in recovery by CDCS. 

Returned Value 

The value returned from a procedure invoked as a 
function, or the value returned by a bulLt-ln 
function* 


Rewind 

An operation that positions a file at 
beginning- 0 f-information. 

RMS 

Refer to Rotating Mass Storage* 

Rollback 

The process of restoring a data base to a 
previous state. 

Rotating Mass Storage (RMS) 

A disk storage device* 

RTL 

Requested Task List. 

Satisfying External References 

The process of searching one or more libraries 
and loading programs that contain entry points 
matching external references that are currently 
unsatisfied. 

Schema 

A detailed description of the internal structure 
of a data base. 

Separator 

A character used to separate parameters in a 
command * 

Sequential (SQ) File 

A file in which records are accessed in the 
order In which they occur* Any file can be 
accessed sequentially* Sequential flies must be 
accessed sequentially because no key or address 
is associated with each record in the flies. 

Source Code 

Code input to the computer for later translation 
into executable machine language instructions 
(object code). 

SQ File 

Refer to Sequential File* 

Stimulator 

A collection of central memory and peripheral 
processor programs which enters a hypothetical 
work load Into the system to analyze the effects 
of such a load on response time and system 
reliability. 


String 

A sequence of contiguous characters or bits 
treated as a unit. 


I C-IO 
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Subschema 

A. detailed description of the portion of a data 
base to be made available to one or more 
applications* 

Supervisory Message 

A message block In the host not directly Involved 
with the transmission of data, but which provides 
information for establishing and maintaining an 
environment for the communication of data between 
the application and NAM, then through the network 
to a destination or from a source* Supervisory 
messages may be transmitted to an N?U in the 
format of a service message* 

TAF Configuration File (TCF) 

A file created and maintained by the data admini¬ 
strator specifying which data managers are active 
and the applications to be associated with each* 

Task 

A program to be executed under the transaction 
subsystem* Tasks are stored in absolute binary 
format on libraries which must be available to 
the transaction subsystem* 

Task Library Directory (TLD) 

The directory on each task library which contains 
Information on the tasks in the library* TAF 
makes its own copy of each TU) at initialization 
and uses this copy to locate requested tasks* 

TCF 

Refer to TAP Configuration File* 

Terminal 

The equipment a person uses to communicate with 
the computer* 

Terminal Class 

An NDL parameter describing the physical attri¬ 
butes of a group of similar terminals, in terms 
of an archetype terminal for the group* 

Terminal Session 

Period between the time you physically connect 
the terminal to the system in preparation for 
login to the time you log out* 

Text Mode 

Mode of entering information into a primary file 
without specifying line numbers* It is usually 
used to create data files* If a file does not 
contain line numbers, you can change lines by 
using an editing facility such as the Full 
Screen Editor* 

TLD 

Refer to Task Library Directory. 


Transaction 

A task or a series of tasks executed as a unit 
under the transaction subsystem* All tasks in a 
transaction have the same transaction sequence 
number* In CDCS, the term data base transaction 
refers to the process which this manual calls a 
begin-commlt sequence* 

Transaction Library Directory (TRD) 

The directory on each task library which contains 
information on the transactions in the library* 
TAF makes its own copy of each TRD at initializa¬ 
tion and uses this copy to locate requested 
transactions* 

Transaction Name 

The one to seven alphanumeric character name 
given to a transaction created with the /tname 
input directive from the LIBTASK utility* 

Transaction Recovery File 

Random permanent file used for before image 
records necessary for recovery by CDCS* 

Transaction Sequence Number 

A unique number assigned by TAF to each transac¬ 
tion. It is used by TAF for task identification* 

Transparent Mode 

A software feature provided by the Network Access 
Method and the network processing unit (NPU). 
When transparent mode transmission occurs between 
an application and a terminal the Network Access 
Method does not convert data to or from 6-bit 
display code, and the NPU does not edit Che char¬ 
acter stream or convert Che characters to or from 
7-bit ASCII code* When no parity is in effect for 
the terminal and transparent mode transmission 
occurs, all seven bits of the character byte can 
be used to represent characters in character sets 
(such as EBCDIC)* 

TRD 

Refer to Transaction Library Directory* 

TST 

Terminal Status Table* 


TTOT 

Table of Time-Originating Tasks. 


UEM 

Unified Extended Memory* 


UJN 

User Job Name* 
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User Index Vgjj 


A unique 17-bit identifier that is associated 
with each user name. The user index Is used by 
the permanent file manager to identify the device 
and catalog crack for the user's files. 

User Name 

A system access word that must be supplied by 
the user for validation purposes at login. 

Utility 

A program designed to help the user perform spe¬ 
cific functions such as permanent file mainte¬ 
nance, library maintanence, and file editing. 

Virtual Terminal 

A software concept for CCP that converts all 
types of upline messages to one of two formats: 
batch virtual terminal or interactive virtual 
terminal. By this method, applications in the 
host need only to be able to process data in IVT 
or BVT format rather than in the multiplicity of 
formats which real terminals use. Downline 
messages from the host to real terminals are 
converted from IVT or BVT to real terminal 
format. The IVT/BVT processors are a part of 
the NPU's network communications software. 

Volume Serial Number (VSN) 

A one- to six-character identifier that identi¬ 
fies the volume of magnetic tape for the opera¬ 
tor. 


Refer to Volume Serial Number. 

Word 

A group of bits (or 6-blt characters) between 
boundaries imposed by the computer system. A 
word is 60 bits in length. The bits are numbered 
59 through 0, starting from the left. It is also 
composed of five 12-bit bytes, numbered 0 through 
4, from the left. 

Working Storage Area 

An area within the user's field length intended 
for receipt of data from a file or transmission 
of data to a file. 

Write Mode 

Allows a user to write, modify, append, read, 
execute, or purge the file (modify permission 
applies only to direct access files). 

xxj Files 

Files created and maintained by the data 
administration which associates a particular 
user with a particular application. 

Zero-Length PRU 

A PRU that contains system information, but no 
user data. Under the CYBER Record Manager, a 
zero-length PRU level of 17 is a partition bound¬ 
ary. Under NOS, a zero-length PRU defines EOF. 


C-12 
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SAMPLE COMMAND LIST STRUCTURES 


D 


The sample commani list structures In this appendix 
demonstrate the use of various parameters that are 
available. The default input and output files can 
be used to reduce the nunber of control language 
statements needed to bring about a compile, load, 
and LIBTASK sequence, because the default binary 
output files are the binary input files for 
subsequent processors. 


For example: 

C0B0L5,TAF,UC1. 

LOAD^LGO. 

NOGO^LGOB. 

LIBTASK^P=RLTASKL,TT. 

It Is assuned that each of the following lists is 
preceded by Job and USER commands. Some sites may 
require a CHARGE command. 


COMPASS TASK COMMAND LIST STRUCTURE 

A sample cosmand list that assembles a COMPASS 
application program and loads it onto a task 
library, RUASKL, is illustrated In figure D-l. 


ATTACH^OPL /UN=use rnaroe. 

COMPASS. 

LDSET,LIB=TRANLIB^LIB=TRANF4. 

LOAD^LGO. 

NOGO^LGOB. 

LIBTASK^P=RLTASKL^B=LGOB TT 1=0. 
end-of-record 

IDENT TASK 
ENTRY TASK 
OPL XTEXT COMKMAC 
C0K8L BSS 69 

. COMPASS task appears here 

END 

end-of-fiLe 


Figure D-1. COMPASS Command List Structure 


FORTRAN TASK COMMAND LIST STRUCTURE 

A sample command list that compiles a FORTRAN 
application program and loads it onto a task 
library, RLTASKL, is illustrated in figure D-2. 


FTN^0B=O.t 

LDSET^L1B=TRANLIB,LIB=TRANF5. 

LOAD^LGO. 

NOGO^LGOB. 

ATTACH^RLTASKL/f1=W- 
LIBTAS K, P=RLTAS KL, TT, 1=0. 
end-of~record 
0VERLAY,ABS,0,0. 

PROGRAM TA$K2 tt 

. FORTRAN task appears here 

end-of-file 


tlhe SEQ, TS, and OPT-0 options are not allowed. 
ttTASK2 is the name of the task. 


Figure D-2. FCHTRAN Command List Structure 


COBOL TASK COMMAND LIST STRUCTURE 

A sample command list that compiles a COBOL 
application program and loads it onto a task 
library, RLTASKL, is Illustrated in figure D-3. 


C0B0L5,TAF,UC1. 

LDSET,LIB=TRANLIB,LIB=TRANC5. 

L0AD,LG0. 

N0G0,LG0B. 

LIBTAS K,P=R LTAS KL,B=LG0B,TT,1=0. 
end-of-record 

. COBOL task appears here 
end-of-f1Le 


Figure D-3. COBOL Command List Structure 


MOTE I note I 


The system OPL must be attached for 
COMKMAC to be called in the COMPASS 
program. Consult site personnel for 
the appropriate command. 


Under COBOL, the PROGRAM-ID name is 
used for the task name. Only alpha¬ 
numeric names can be used as task 
names. 
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FILES USED BY TAF 


E 


Table E-1 lists files used by TAF. 


Table E-1. Files Used by TAF 


Name 

File Name 

Typet 

Creation 

Residence 

Quantity 

Description 

Communication 
recovery file 

ZZCRFi 

D 

Automatic 
if K.INT 
declared 

Same as 

NCTFI 

1-8 

Contains recovery informa¬ 
tion for each user. In¬ 
cludes status, initial in¬ 
put, RPUT messages, and 
SECURE message. 

Before image 
recovery file 

ZZxxBnn 

D 

User or 
automatic 

Application 

1-63 
per data 
base 

Contains before images of 
data records. 

After image 
recovery file 

ZZxxAnn 


User or 
automatic 

Application 

2 

Contains after Images of 
data records. 

Network 

file 

NCTFi 


User 

Specified in 
TCF; default 
is TAF UI 

B 

Defines valid users for 
each network id. 

Temporary 
recovery file 

ZZCEFAl 


Automatic 

Local 

1 

Created during CRF refor¬ 
matting. Becomes new CRF. 

Backup 

directory file 

ZZxxDIR 


Automatic 

Application 

1 per 

data 

base 

Contains record of data 
file dumps and ARF dumps. 

TAF Initializa¬ 
tion procedure 
file 

Selected 

by 

user 


User or 
automatic 

System 

1 

Contains commands for ini¬ 
tializing and recovering 
TAF. 

TAF 

initialization 

file 

Z2TIF 


Automatic 

Local 

1 

Contains TAF low core 

pointer TST. 

TAF initial¬ 
ization recovery 
report 

ZZIRBF 


Automatic 

Local 

1 

Contains recovery report 
for data administrator. 

TAF 

configuration 

file 

TCF 

1 

User 

TAF 

1 

Specifies data managers and 
applications in use. Con¬ 
tains K display commands, 

CRF ids, NCTF ids. 

xxJ 

file 

xzJ 

I 

User 

TAF 

1 per 

data 

base 

Associates applications 
with data managers and de¬ 
scribes data files and 
their attributes. 

System task 
library 

TASKLIB 

D 

User 

TAF 

X 

Contains required and op¬ 
tional system tasks and 
transactions. 

Task library 

xxTASKL 

n 

User 

Application 

1 per 

data 

base 

Contains all tasks and 
transactions for a par¬ 
ticular application. 

T Type D is a direct access permanent file; type L is a local file; type I is an indirect permanent file. 


E-1 


60459500 A 












































































In addition to the files described in table E-1, the SCRA-SCRZ 

following reserved files are used by TAP, No task 

or procedure file called by TAP can attach or use SCR1-SCR5 

any file having one of these names. 

TROB 

KTSROLL 

MAP 

OUTPUT 

ZZZZZ*. (file names starting with five Zs) 

RECOVER 


E-2 
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INSTALLATION OVERVIEW 


F 


Table F-1 is provided to aid the systems analyst and 
data administrator in performing TAF installation. 
It is a chronologically ordered outline of the 


procedures detailed in the respective manuals 
complete name and publication number of each 
in the Manual column follows the table. 




The 

entry 
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Table F-1. Installation Overview (Sheet I of 3) 


Area 

Step 

Manual 

Manual Keyword 

1. Install KOS. 


NOS IHB 

NOS ANHB 


2. lascall 

communications 

subsystem* 


NOS IHB 

NOS ANHB 

CCP Reference 

NAM Reference 

NDL Reference 


3* Install 
product set 
(COBOL, and 
so forth)* 


NOS IHB 

COBOI, 5 

FORTRAN 4 

FORTRAN 5 

COMPASS 

4* Modify/create 
TAF subsystem. 

1* Evaluate installation parameters* 

Some items of interest at initial 
installation are: 

• TAF username• 

• TAF user index* 

• TAF password * 

• TAF charge, project numbers* 

• TAF consnunication Interface ** 

2530s or multiplexers* 

• Number of terminals* 

2* Modify TAF on deadstart media if 
required, or 

3* Modify TAF on a running NOS system* 

4* Install TAF username and charge* 

5. Install procedure file to initiate TAF* 

6* Install automatic initiation of TAF upon 
deadstart if desired* 

NOS IHB 

NOS IHB 

NOS Reference V3 

NOS ANHB 

NOS IHB 

NOS ADHB 

NOS IHB 

NOS ANHB 

Transaction 

facility 

Transaction facil¬ 
ity, GTR, LIBEDIT, 
LIBGEN 

SYSEDIT 

TAF installation 
parameters 

MODVAL, PROFILE 

TAF 

IPRDECK 

5* Install 
transaction 
application* 

1* Assign a team to do data base design* TAF 
interfaces to CDCS, CRM, and TOTAL* Areas 
in data base design that require examine*- 
tlon Include: 

• Elements to be accessed* 

• Relationships between the elements* 

• Data manager to be used* 

• File, record types, and element 
types to be used to store the data* 

• Data formats for the tasks* 

• Mass storage of the data base* 

TAF Reference 

TOTAL Reference 

AAM Reference 
TAF/CRM Reference 
TAF User^'s Guide 
CDCS Reference 
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Table F-1. Installation Overview (Sheet 2 of 3) 


Specific processing to be assigned to 
tasks and the relationships between 
tasks. For TAP, tasks Involved with 
I/O should be small since the tasks 
will occupy memory for some time. 
Tasks that are often used and run 
quickly may be made core-resident. 
Tasks that are often used should be 
reusable to avoid task loading. 

Data base recovery. 


Manual Keyword 


2. Assign a team to do the communications 
interface. Areas to examine are: 

• Network Access Methods features 
and workings. 

• Communication Control Program 
and 2330 hardware, communication 
lines, terminals, and so forth. 

• Network definition language (NDL). 

• TAF terminal I/O requests. 


NAM Reference 


CCP Reference 


NDL Reference 


TAF Reference 


Message formats, terminal operator 
interactions. 


• Recovery of terminal communications. 

• Interface specifications with the 
tasks^s data management activities. 

• NOS and network stimulators. 


NOS ANHB 
NFS Reference 


3. Install a prototype application using the 
following steps. Revise design as more Is 
learned about the capability and perform¬ 
ance trade-offs. Use stimulators to test 
the design under a large terminal load. 

4. Describe and install the data base using the 
appropriate data manager. 


TAF Reference 
COGS Reference 


• CRM. 


TAF Reference xxJ files 

TAP/CRM 

Reference 


• TOTAL. 


TAF Reference xxJ files 
TOTAL Reference 


3. Describe and install terminal network files. 


A. Install TAF^s NCTFi file. 


TAF Reference 
NOS ANHB 


Network files 
Network description 
files 


B. Install NAM"s LCF and NCF network 
files. 


NDL Reference 


C. Install terminal users in NOS 
validation files. 


MODVAL, PROFILE 


6. Modify procedure file that Initializes TAF 
for special preprocessing procedures, 
such as preparing for recovery. 


NOS IHB 
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Table F-U Installation Overview (Sheet 3 of 3) 


7. Write application tasks. 


• COBOL 5. 


TAF Reference 
TAP User^'s Guide 

COBOL 5 Reference 
COBOL 5 User's 
Guide 


Manual Keyword 


• FORTRAN 4. 


• FORTRAN 5. 


FORTRAN 4 
Reference 

FORTRAN 5 
Reference 


• COMPASS. 


8. Modify XTASK to map transaction codes to 
their associated transactions. Code for 
handling system transactions and error 
processing may be desired depending upon 
application. 

9. Modify other TAF-furnished system tasks if 
desired• 


COMPASS Reference 
NOS Reference V4 

TAP Reference 
NOS IHB 


TAF Reference 


System tasks 


• LOGT - terminal logout request. 

• MSABT - task. 

• SYSMS6 - TAF system messages. 


• RCTASK. 


# CTASK. 


• BTASK. 


6. Test the 
transaction 
application. 


7. TAF operation 
al commands. 


8. Modify per¬ 
formance of 
TAF and 
application. 


• CRMTASK. 

• Interface specifications with the 
tasks data management activities. 

10. Build data base task libraries. 

11. Build TAF system library. 

12. Build data base journal files xxJ to give 
TAF user name for data base. 

13. Build the TAF configuration file. 


TAF/CRM Reference 

TAF/CRM Reference 
CDCS Reference 

TAF Reference 

NOS IHB 
TAP Reference 

TAF Reference 
TAF/CRM Reference 

TAF Reference 


LI BTASK 
TAP 

LIBTASK 

xxJ files 
xxJ files 



1. Initialize TAF from computer console. 

2. Status TAF from computer console. 

3. Terminate TAF from computer console. 


1. TAF installation parameters. 



Transaction 

subsystem 
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Control Data Manual 

Manual Title 

Publication Number 

AAM Reference 

CYBER Record Manager Advanced Access Methods 

Version Z Reference Manual 

60499300 

CCP Reference 

Comtaunicatlons Control Program Version 3 

Reference Manual 

60471400 

CDCS Reference 

CYBER Database Control System Version 2 

Data Administration Reference Manual 

60485200 


CYBER Database Control System Version 2 

Application programming Reference Manual 

60485300 

COBOL 5 Reference 

COBOL Version 5 Reference Manual 

60497100 

COBOL 5 User's Guide 

COBOL Version 5 User's Guide 

60497200 

COMPASS Reference 

COMPASS Version 3 Reference Manual 

60492600 

FORTRAN 4 Reference 

FORTRAN Extended Version 4 Reference Manual 

60497800 

FORTRAN 5 Reference 

FORTRAN Version 5 Reference Manual 

60481300 

NAM Reference 

Network Products Network Access Method Version 1 
Reference Manual 

60499500 

NDL Reference 

Network Products Network Access Method Version 1 
Network Definition Language Reference Manual 

60480000 

NOS AOHB 

NOS Version 2 Administration Handbook 

60459840 

NOS ANHB 

NOS Version 2 Analysis Handbook 

60459300 

NOS IHB 

NOS Version 2 Installation Handbook 

60459320 

NOS OHB 

NOS Version 2 Operations Handbook 

60459310 

NOS Reference V3 

NOS Version 2 Reference Set, 

Volume 3, System Commands 

60459680 

NOS Reference V4 

NOS Version 2 Reference Set, 

Volume 4, program Interface 

60459690 

NPS Reference 

Network Products Stimulator Version 1 

Reference Manual 

60480500 

TAF/CRM Reference 

TAF/CRM Data Manager Version 1 

Reference Manual 

60459510 

TAF Reference 

TAF Version 1 Reference Manual 

60459500 

TAF User's Guide 

TAF Version 1 User's Guide 

60459520 

TOTAL Reference 

TOTAL - CDC Version 2 Reference Manual 

76070300 
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TERMINAL DEFINITION COMMANDS 


G 



INTRODUCTION 

The network, through which terminals access a host 
and Its applications (like TAF), can support many 
types of terminals* All supported terminals are 
grouped by the network into 18 standard terminal 
classes* Each terminal class has specific operating 
characteristics, also referred to as terminal 
characteristics* These terminal characteristics, 
taken together, make up a terminal definition and 
are predefined by the network to closely match the 
operating characteristics of actual terminals* The 
network accepts changes to any of these terminal 
definitions through terminal definition commands* 
These commands specify one or more parameters, each 
of which may give a new value to a terminal char¬ 
acteristic. Tables 6-1 and G-2 list these terminal 
definitions, the default values, and possible values 
for each of the 18 classes* 


The tables use the following abbreviations when iden¬ 
tifying the terminal types for each terminal class: 


Abbreviation 

HASP 

HAZ 

POST 

PRE 

Tek 

TTY 

or 

X*25 


X3.64 


Terminal 


Terminals using the Houston 
Automatic Spooling Program 
communication protocol* 

Hazeltlne* 

HASP terminals that only sup¬ 
port postprlnt format control* 

HASP terminals that only sup¬ 
port preprint format control* 

Tektronix (teletypewriter emu¬ 
lation) • 

Teletype * 

User Terminal* 

Terminals connected to a packet 
switching network (PSH) using 
the X*25 communication proto¬ 
col* 

Terminals conforming to the 
ANSI X3.64 standard* 


When a terminal logs in to the network, either the 
network assumes it to be of a certain terminal class 
or assigns it a terminal class that resembles the 
terminal's actual characteristics* If you do not 
know the terminal class in use, you can enter the CH 
command (described in this appendix) to ascertain 
the terminal class and some of the characteristics 
of your terminal* In either case, if the character¬ 


istics of your terminal do not match those of its 
assigned terminal class, you can change the values 
of the terminal characteristics or even change the 
terminal class by using the terminal definition 
commands described in this appendix* You can enter 
terminal definition commands any time the terminal 
is connected to the network (refer to appendix J for 
information on how to access a host)* 

When you use a terminal definition command to change 
a value, that change remains in effect until the 
terminal is disconnected from the network or another 
terminal definition command is used to change the 
value* Even application switching and logout do not 
change the values of the terminal characteristics if 
the terminal has not been disconnected from the 
network. Disconnecting your terminal from the net¬ 
work (that is, disconnecting the phone and redialing 
on dial-up terminals or turning a dedicated terminal 
off and then on again) causes all terminal character¬ 
istics to be reset to site-defined default values* 
The site defines these values using the Network 
Definition Language (NDL). 

You can also reset your terminal's characteristics 
by entering the TC command* The TO command resets 
your terminal characteristics to the default values 
specified by the Communications Control Program 
(CCP)* Note that CCP-deflned values may differ from 
the site-defined NDL values* 

It is also possible to change terminal definitions 
using the TRMDEF command or by using control byte 16 
from an interactive job* The TRKDEF command is 
described under Terminal Control Commands in the NOS 
Reference Set, Volume 3, System Commands* Refer to 
NOS Reference Set, Volume 4, Program Interface, for 
information on control bytes* 


TERMINAL DEFINITION COMMAND FORMAT 

This section describes the general format of a 
terminal definition command* The specific format of 
each command appears later in this appendix* 

General formats: 

ct keyword»valuet 

ct keyword^«valuei ct keyword 2 *value 2 
***ct keywordn»value,it 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command* Table G-l gives 


tThe spaces shown are for clarity only* Do not Include spaces when you enter a terminal definition command* 
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Parameter Deacrlptlon 

the default network control char¬ 
acter for your terminal.t 

keyword Represents a mnemonic associated 

with a terminal characteristic. 


value Specifies a particular value 

associated with the terminal 
definition mnemonic. Table G-2 
gives the range of values for 
each terminal definition key¬ 
word. On some commands the 
■value portion of the command is 
optional and defaults to -Y. 

keywordi Same as keyword. 

value^ Same as value. 


The second format allows you to make multiple ter¬ 
minal definitions in one line. If the line extends 
beyond character position 54, the results are unpre¬ 
dictable. Also, if you change the network control 
character ct in a concatenated group of commands, 
the CT command does not take effect until the re¬ 
maining commands in the group have been processed* 


As with all commands described in this manual, you 
must press the message transmission key in order for 
the system to process your command. Appendix K of 
the KOS Reference Set, Volume 3, System Commands, 
shows the default message transmission keys for the 
various terminal classes. This appendix describes 
how you can change the message transmission key 
(refer to the EB and EL commands). 


Example: 


To change the page width of a 200 User Terminal, 
enter these characters 


ZPW-50 


and press the SEND key. The X character is the 
network control character, PW is the keyword 
associated with page width, 50 is the new page width 
for the terminal, and the SEND key is the message 
transmission key for a 200 User Terminal. 


RESTRICTIONS 


You should not enter terminal definition commands 
while output is in progress. The network may not be 
able to perform such commands Immediately* 

The network presets all user-adjustable terminal 
characteristics any time you establish a connection 
to the network. The site administrators choose 
these preset values. Additionally, when a terminal 
is disconnected from the network and then recon¬ 
nected, the network resets any terminal character¬ 
istics you have changed to their preset values. 

To enter a terminal definition command at asynch¬ 
ronous terminals from which you can enter more than 
one line before transmitting (IN**BK is specified). 


the terminal definition command must be the last 
input line in the transmission* If the input is from 
paper tape (IN»PT is specified), the tape reader must 
stop. Unpredictable results can occur if more input 
follows the terminal definition command in the trans¬ 
mission block* 

Characters or character codes you specify for the 
value portion of terminal definition commands are 
subject to the following restrictions: 

• You cannot use the following ASCII charac¬ 
ters (or their character codes) in the value 
portion of the AB, CN, BS, Bl, B2, CT, EB, 
or EL commands: 

any lowercase or uppercase alphabetic 
character 

any digit 0 through 9 

NUL 

SOH 

STX 

■ 

DEL 

space 

• The ASCII characters or character codes you 
specify for the AB, BS, Bl, B2, CN, CT, EB, 
and EL terminal definitions must all be 
different, except that AB and CN can have 
the same value and EB and EL may have the 
same value. 

• If output flow control is used, do not use 
DCls and DC3s in the AB, CN, BS, Bl, B2, CT, 
EB, or EL commands* 


TERMINAL DEFINITION COMMANDS 

This subsection describes the function and format of 
each terminal definition command* The headings 
consist of the command name (a two-character 
mnemonic) followed by the terminal attribute It 
defines* Generally, the format descriptions do not 
show the default values or ranges of values since 
they vary with terminal class. Tables G-l and G-2 
show this information* If you are unable to find 
the key on your keyboard that corresponds to a 
particular character given in table G-l, consult the 
documentation for your terminal. 

This section refers to categories of terminal classes 
to which commands apply* The categories are as 
follows: 


Category 
Asynchronous 
Mode 4 
HASP 

Bisynchronous 
X.25 PSN 
3270 


Terminal Classes 
1 through 8 
10, 11, 12, 13, 15 
9, 14 

16, 17, 18 
1, 2, 3, 5, 6, 7. 8 
18 


tYou must press the ATTN key on a 2741-compatible terminal before entering this character. 


G-2 
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(AB) - ABORT OUTPUT BLOCK CHARACTER 


(BP) - BLOCKING FACTOR 


The AB command specifies the character used to abort 
an output block. When you enter this character from 
the terminal as the only character in a line, the 
current transmission block of output to the terminal 
is discarded. 

Format: 

ct AB*ab 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command, 

ab Specifies the new abort output 

block character. This character 
must differ from the characters 
defined for BS, Bl, B2, CT, SB, 
and KL, 

This command only applies to asynchronous terminals 
and is not valid for K,25 PSN tei^nals. 


(AR) - AUTOMATIC CHARACTER RECOGNITION 

The AR command allows you to change the terminal's 
character set or its line speed, in many cases, by 
means of a switch on the terminal or a removable 
type ball. You can enter this command any time 
after the system prompts you for input, even before 
you enter your user name during login. 

Format: 

ct AR 


The BF command sets the size of Intermediate data 
blocks that will be delivered to the host. 

Format: 

ct BF-bf 

Parameter Description 


ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

bf Specifies the blocking factor. 

You can specify the following 
values for bf: 

bf Description 

0 Selects a line feed 

character and a char¬ 
acter count of 100 
as data-forwarding 
signals, 

1 Selects a character 

count of LOO as a 
data-forwarding 
signal, 

2 Selects a character 

count of 200 as a 
data-forwarding 
signal, 

Regardless of the blocking factor, an end-of-line 
character (carriage return) forwards data to the 

host. 


Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command. 

After entering the AR command, you must select the 
terminal speed and enter a carriage return. The 
system acknowledges the carriage return operation 
and indicates that the line speed recognition is 
complete by returning two line feeds. If your 
terminal cannot change its line speed, no line feed 
responses occur. At this point, enter a closing 
parenthesis followed by a carriage return so that 
the system can recognize the terminal's new 
character set. When the system recognizes the new 
character set, It issues a line feed and the message 
AR ACCEPTED., to Indicate you can continue. This is 
also the auto-recognition procedure used to connect 
the terminal to the system (refer to the login/ 
logout procedures in Volume I, Introduction to 
Interactive Usage). 

This command only applies to asynchronous terminals 
and Is not valid for X.25 PSN terminals, X,23 PSN 
terminals use the ASCII code and character set. 


(BR) • BREAK KEY AS USER BREAK 1 

The BR command determines if the BREAK key 
(interruption key for interactive output) also 
functions as the interruption sequence (user break I 
sequence) when entered during output and as the 
cancel character when entered during input. 

Format: 


ct BR*option 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 


option Determines if this feature is en¬ 
abled or disabled, A value of Y 
enables and a value of N disables 
this feature. 


This command only applies to asynchronous terminals- 
For X.25 PSN terminals, the BREAK key can only 
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function as the interruption sequence whether entered 
during Input or output. 


(BS) - BACKSPACE CHARACTER 

The BS command specifies the character used to 
delete the previous Input character. 

Format: 

ct BS«bs 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

bs Specifies the new backspace char¬ 

acter. This character must dif¬ 
fer from the characters currently 
defined for AB, Bl, B2, CN, CT, 
EB, and El«. 

It Is possible to backspace only to the beginning of 
the current physical line; additional backspaces are 
disregarded. When a page width of 0 is selected, 
the network assumes a page width of 100 characters 
for backspacing. If the page width is In the range 
20 through 56, backspacing into previous physical 
lines Is sometimes permitted. 

This command only applies to asynchronous terminals 
only. 


(Bl) . INTERRUPTION OR USER BREAK 1 CHARACTER 

The BI command specifies the character that, when 
entered as the only character in a logical line 
(Interruption character followed by the message 
transmission key), causes program Interruption. 

Format: 

ct Bl»ubl 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

ubl Specifies the new user break I 

character. This character must 
differ from the characters cur¬ 
rently defined for AB, BS, B2, 
CN, CT, SB, and Eli. 

The interruption sequence Is discussed in section 17. 
The BR command determines whether the BREAK key can 
also function as the Bl character. 

This command does not apply to bisynchronous 2780 
and 3780 terminals. 


(B2) - TERMINATION OR USER BREAK 2 CHARACTER 

The B2 command specifies the character that, when 
entered as the only character In a logical line (ter¬ 
mination character followed by the message transmis¬ 
sion key), causes program termination. 

Format: 

ct B2«ub2 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

ub2 Specifies the new user break 2 

character. This character must 
differ from the characters cur¬ 
rently defined for AB, BS, BI, 
CN, CT, EB, and EL. 

The termination sequence Is discussed In section 17. 

This command does not apply to bisynchronous 2780 and 
3780 terminals. 


(CH) . DISPLAY TERMINAL CHARACTERISTICS 

The CH command displays some of the terminal's cur¬ 
rent characteristics. 

Format: 

ct CH 

Parameter Description 


ct Elepresents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

The CH command produces a display in the following 
format: 

TC»tc,BS-bs,CN»cn,AB»ab,Bl-ubl,B2*ub 2,EL»el,EB»eb 

where the variable portions appear as ASCII charac¬ 
ters If printable, mnemonics (for example, STX) If 
nonprintable, or N/A If the attribute Is not appli¬ 
cable. 


(Cl) - CARRIAGE RETURN IDLE COUNT 

The Cl command specifies the number of Idle charac¬ 
ters to be Inserted Into the output stream after a 
carriage return. 

Format: 

ct Clad 
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Parameter 


Description 


Parameter 


Description 



Represents the network control 
character for your terminal as 
defined by the CT terminal 
definition command. 


ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 


ci Specifies the new carriage return 

idle count. This value can be 
from 0 to 99 or the string CA. A 
value of CA restores the carriage 
return idle count to the default 
value. 

When the network produces a carriage return, the 
network outputs the specified number of idle charac¬ 
ters before outputting the next line. This allows 
time for the carriage return function and ensures 
that characters are not lost because of printing 
attempts during the carriage return operation. 

This command only applies to asynchronous terminals. 


option Indicates whether to send a res¬ 
ponse to the terminal or not. A 

value of Y indicates yes and N 

indicates no. 

This command applies only to asynchronous Cerminals 
(except 2741s). If CP-Y and IN»KB are selected, the 
system responds to the line feed key by sending a 
carriage return and responds to an EL or EB charac¬ 
ter by sending the cursor positioning response 
specified by the EL or EB command. If IN**BK is 

selected or you are at an X.25 PAD terminal, the 

system responds only to the EB character by sending 
the cursor positioning response selected by the EB 
command. 



(CN) . CANCEL CHARACTER 

The CN command specifies the character used to cancel 
the logical line currently being input. 

Format: 

ct CN«cn 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

cn Specifies the new cancel char¬ 

acter. This character must 
differ from the characters 
currently defined for BS, Bl, 
B2, CT, EB, and EL. 

When you enter the cancel character as the last 
character in a line, the entire logical line in 
progress is cancelled. The system responds to a 
cancel line character by printing *DEL* on the next 
line and positioning the carriage to the beginning 
of a new line. The BR command determines whether 
the BREAK key can also function as the CN character. 

This command does not apply to bisynchronous 2780, 
3270, and 3780 terminals. 


(CP) . CURSOR POSITIONING AFTER INPUT 

The CP command determines whether or not the system 
sends the terminal a response to the line feed key, 
the EL character, and the EB character. 

Format: 

ct CP*optlon 


(CT) - NETWORK CONTROL CHARACTER 

The CT command specifies a network control character 
for the terminal. When you enter this character as 
the first character of a logical line, it signals 
that what follows is a terminal definition command 
or a special command that the network forwards to 
your application with a preemptive status. 

Format: 

ct CT«char 

Parameter Description 

ct Represents the current network 

control character for your ter¬ 
minal. 

char Specifies the new network con¬ 

trol character. This character 
must differ from the characters 
currently defined for AB, BS, 
Bl, B2, CN, SB, and EL. 

If you enter the CT command in a line with multiple 
terminal definitions, the new value char does not 
take effect until the complete line is processed. 


(DL) . DELIMITERS FOR SINGLE-MESSAGE TRANSPARENT INPUT 
MODE 

The DL command specifies the delimiters that 
terminate single-message transparent input mode. 
When you initiate transparent Input mode (IN"X, 
IN-XK, or IN»XP), the network reads your Input and 
sends It to the system without translation until it 
encounters a delimiter. If your terminal's parity 
Is set to even, odd, or zero (PA«E, 0, or Z), the 
parity bit is stripped (set to zero) before the 
characters are sent to the host, although no 
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translatloa occurs* If your tennlnal'^s parity is 
set to none or ignore (PA-N or I), the parity bit is 
not stripped. See the NAM/CCP Terminal Interfaces 
Reference Manual for more information on transparent 
input and parity. The first delimiter encountered 
terminates transparent input mode. 


the SEND or ETX key as their only transparent mode 
terminator. For X.25 devices> the PAD forwarding 
signal always acts as a transparent mode terminator 
in addition to any other options selected. 


Format: 


(EB) . END-OF-BLOCK CHARACTER 


ct DL»Xxx,Ccount,TO 


Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command. 


Xxx Specifies the 2*digit hexadecimal 

code (xx) of the character you 
want as a delimiter. The network 
does not send the character as 
part of the input data, bfhen you 
specify a hexadecimal code above 
7F, you must have previously set 
your ter- minal''s parity to none 
(PA*N) or ignore (PA«I); other¬ 
wise the network cannot detect 
the code when it occurs In a 
transparent mode message. If the 
terminal's parity is set to none, 
the 8-blt hexadecimal code input 
from the terminal is matched 
against the 8-bit hexadecimal 
code specified as the delimiter 
(xx). If the terminal's parity 
is set to ignore, the bottom 7 
bits of the terminal input are 
matched against the bottom 7 bits 
of the specified delimiter (xx). 

Ccount Specifies a decimal value (count) 
from 1 to 40951 that functions 
as a character count delimiter. 


TO Specifies that a timeout of be¬ 

tween 200 and 400 milliseconds 
will be a transparent mode de¬ 
limiter. 


The EB command defines the end-of-block character 
and defines the cursor-positioning response to that 
character. The EB character acts as the message 
transmission key for terminals operating in block 
mode (refer to the IN command). 

Format: 

ct EB«eb,cpr 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command. 

eb Specifies the new end-of-block 

character. You can specify the 
following values for eb: 

eb Description 

char Selects the new EB 

character. This 

character must dif¬ 
fer from the charac¬ 
ters currently de¬ 
fined for AB, BS, Bl, 
B2, CN, and CT. 

EB Selects the default 

end-of-block charac¬ 
ter or character se¬ 
quence . 

EL Selects the current 

logical end-of-line 
character• 


You can select any of the three types of delimiters: 
character delimiter (specify Xxx), character count 
delimiter (specify Ccount), and timeout delimiter 
(specify TO). 

The parameter values for DL are order-independent 
and optional. However, you must specify at least 
one of the parameter values. You can omit trailing 
commas If you do not specify all three types of 
delimiters. 

Entering this command with any number of new 
delimiters cancels all transparent mode Input 
delimiters already in effect, including those 
specified with the XL command. 

The DL command applies only to asynchronous and mode 
4 terminals* Terminal class 4 is configured with 
the RETURN key as the only transparent mode 
terminator and mode 4 terminals are configured with 


Specifies the cursor-positioning 
response to the EB character. 
You can specify the following 
values for cpr: 

cpr 

Description 

CR 

Send a carriage re¬ 
turn to the terminal. 

LF 

Send a line feed to 
the terminal. 

CL 

Send a carriage re¬ 
turn and a line feed 
to the terminal* 

NO 

Send no response. 


The two EB parameters (EB=»eb and cpr) are optional 
and order-independent. If you omit one, the system 
retains its previous value* 


tThese values are valid within the network. However, unless changed during Installation, the maximum logical 
input line length in lAF (160 characters) limits you. 
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This command is valid only for asynchronous ter¬ 
minals, except for paper tape devices and 2741 ter¬ 
minals. The end-of-block character for mode 4 ter¬ 
minals is ETX and is not changeable. The X.25 PAD 
forwarding signal is the default for X.25 PSN ter¬ 
minals and always acts as an end-of-block. If you 
specify the char form of the eb parameter, it is only 
effective if it occurs as the last character in a 
packet sequence. 

The CP command enables or disables the cursor- 
positioning response specified by the cpr parameter. 


(EL) - END-OF-LINE CHARACTER 

The EL command defines the logical end-of-llne 
character (carriage return) and defines the cursor- 
positioning response to that character. It also 
defines the message transmission key for asynch¬ 
ronous terminals not operating in block mode (refer 
to the IN command). 

Format: 


cpr 


Description 

CL 

Send 

a carriage re- 


turn 

and a line feed 


to the terminal. 

NO 

Send 

no response. 


The two EL parameters (el and cpr) are optional and 
order-independent. If you omit one, the system 
retains its previous value. 

This command does not apply to 2741, HASP, 3270, and 
bisynchronous 2780 and 3780 terminals; the cpr 
parameter does not apply to mode 4 or X.25 PSN 
terminals; and the char specification does not apply 
to mode 4 terminals. 

The CP command enables or disables the cursor- 
positioning response specified by the cpr parameter. 

(EP) • ECHOPLEX MODE 

The EP command enables or disables the echoing of 
input characters back to the terminal. 


ct EL*el, cpr 


Format: 


Parameter 


ct 


el 


Description 

Represents the network control 
character for your terminal as 

defined by the CT terminal 
definition command. 

Specifies the new logical end-of- 
llne character. You can specify 
the following values for el: 

el Description 

char Selects the new EL 

character. This 

character must dif¬ 
fer from the charac¬ 
ters currently de¬ 
fined for AB, BS, 
Bl, B2, CN, and CT. 

EB Selects the current 

end-of-block char¬ 
acter or character 
sequence. 

EL Selects the default 

logical end-of-llne 
character. 


ct EP«»optlon 
Parameter 
ct 


option 


Description 

Represents the network control 
character for your terminal as 
defined by the CT terminal 
definition command. 

Specifies whether to enable (Y) 
or disable (N) input echoing. 


Some terminals can perform their own character 
echoing, such as terminals with a HALF/FULL duplex 
switch. If the switch is In the HALF position, set 
the EP value to N, and the terminal echoes the 
Input. If the switch Is in the FULL position, set 
the EP value to Y and the network echoes the input. 

You can use the EP command and full-duplex mode as a 
security measure. If you are in full-duplex mode 
and BP is Y during login, the system echoes all of 
your input except your password. This is not true, 
however, if you enter your user name and password on 
the same line. 

This command only applies to asynchronous terminals 
(except 27413) but Is not valid for X.25 PSN 
terminals. 


cpr Specifies the cursor-positioning 

response to the EL character. 
You can specify the following 
values for cpr: 


(FA) • PUU ASCII INPUT MODE 


cpr 


Description 

The FA command 

CR 

Send 

a carriage re- 

Input mode. 


turn 

to the terminal. 

Format: 

LF 

Send 

a line feed to 

ct FA-optlon 


the 1 

terminal. 
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Parameter 


ct 


option 


Deacrlptlon 

Represents the network control 
character for your terminal as 
defined by the CT terminal def¬ 
inition command* 

Specifies whether to enable (Y) 
or disable (N) the full-ASCII 
input mode* 


In full-ASCII input, all 128 ASCII characters. 

Including NUL, DEL, STX, LF, and all BLK and 

message-forwarding signals (which are normally 
discarded), are sent to the host* Exceptions to 
this are the following characters: 

• NULs, DELS and LFs when encountered as the 

first character of an input line or as the 

character following a message-forwarding 
signal 

• CRs that follow LFs when inputting from 
paper tape 

• DCSs that follow the EL character when in¬ 
putting from paper tape 

• DCls and DCSs when output control (OC*Y) is 
selected 

In full-ASCII mode, the network does not recognize 
the terminal functions associated with the mnenomlcs 
Bl, B2, CN, AB, and BS* The network does recognize 
terminal definition commands and other commands 
beginning with the CT character* 

If SE is in effect when you select FA or if FA Is in 
effect when you select SB, FA takes precedence and 
SE will not be effective until FA la turned off* If 
full-ASCII mode is enabled when you select trans¬ 
parent input mode, the network suspends the full- 
ASCII mode until the transparent input mode 
terminates* 

This command only applies to asynchronous and mode 4 
terminals. 


(HC) - HOST CONNECTION 

The HC command sets or changes the host connected to 
your terminal. The host availability display (HAD) 
shows the available hosts (refer to the HD command 
for more information on the HAD). This command 
disconnects you from your current host and 
establishes a new host connection* This command is 


The host selected is used until either you change it 
or until your terminal is disconnected from the host* 


(HD) . DISPLAY OF HOST NODES 

The HD command controls when Che system displays the 
host availability display (HAD), which shows all 
paths you can select to connect your terminal to a 
host* If your computer system is a multihost 
system, your site may choose to show the HAD 
whenever you disconnect from a host unless you 
inhibit the display* 

Format: 


ct HD»optlon 
Parameter 
ct 


option 


Description 

Represents the network control 
character for your terminal as 
defined by the CT terminal def¬ 
inition command* 

Represents Y or N* Y enables 
and N disables the automatic 
displaying of the HAD* 


If you specify HD»Y, you get a display of the HAD 
immediately and at any time you disconnect from the 
host (for example, after you enter the TM command or 
after you log out of an application without 
switching to another application). You also get a 
header and trailer line along with the HAD (refer to 
the TM command). 

The HAD has the following format: 

message CONTROL CHARACTER»ct 

NPU NODE»npu TERMINAL NAME-terminal 


HOST 

NODE 

SELECTED/ 

CONNECTED 

STATUS 

host^ 

nodei 

conditioni 

status 1 

ho3t2 

• 

node 2 

• 

condition 2 

• 

status 2 

• 

• 

hostfi 

noden 

• 

condition^ 

• 

• 

statusn 


The variable items in the display have the following 
descriptions * 


equivalent to HS or 

HN followed by TM* 

Item 

Description 

Format! 

ct 

HC«hostname 


message 

A message describing the status 
of your current host connection* 


Parameter 

Description 

ct 

Network control character cur¬ 
rently defined for your terminal* 


ct 

Represents the network control 
character for your terminal as 
defined by the CT terminal def¬ 
inition command* 

npu 

The node number of the Network 
Processing Unit (NPU) your ter¬ 
minal is connected to* 


hostname 

specifies the name of the host 
to which you want your terminal 
connected* The valid entries 

appear in the HAD* 

terminal 

hostj^ 

The name of your terminal* 

Represents the 1- to 7-character 
name of a host* The field may 
be blank* 
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Item 


Description 


node^ 

condition^ 


status^ 


Represents a node number (1-31)* 

Indicates that you have selected 
node^ (S), that you are con¬ 
nected to the host using nodej^ 
(G), or that node^^ has been 
automatically selected and the 
connection to the host is in 
progress (SA)« 

Represents AVAILABLE or NOT 
AVAILABLE. 


(HN) - HOST NODE SELECTION 

The HN command sets or changes the host or the path 
(node) to a host through which your terminal is 
connected. This coamand does not disconnect you 
from your current host connection. You must log out 
or disconnect with the Secure Login command or TK 
terminal definition cootmand before you can connect 
to the new selection. 


Your terminal uses the path to host with the least 
traffic. The path selected is used until either you 
change It or until your terminal is disconnected 
from the host. 


(1C) - FLOW CONTROL FOR INPUT DEVICES 

The IC command specifies whether the terminal 
recognizes DC3s as a stop signal and DC Is as a 
resume signal for terminal input. 

Format: 

ct IC“option 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

option Specifies whether to enable (Y) 

or disable (N) input control. 


Format: 

ct HN-node 


Input control applies to asynchronous terminals» 
including paper tape devices (except 2741 and X.25 
PSN terminals). 


Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command. 


node Specifies a node number. The 

default is the node the network 
processing unit is presently 
using to access its supervisor 
(CS). 


The host availability display (HAD) lists all nodes 
your terminal can use. Refer to the HD command for 
a description of the HAD. 


(HS) . HOST SaEaiON 

The HS command selects a host which is connected to 
your terminal. The host availability display (HAD) 
shows the available hosts (refer to the HD command). 


(IN) . INPUT DEVICE AND TRANSMISSION MODE 

The IN command identifies the input device and the 
transmission mode of the device. As the input 
device* you can specify one of the following: 

• A keyboard« 

• A paper tape reader. 

As the input transmission mode* you can specify 
either: 

• Normalized line mode (one message or logical 
line per terminal transmission block). 

• Normalized block mode (one or more logical 
lines or messages collected into a block 
before it is transmitted). 

• Transparent mode (Input is not edited or 
translated by the network). 


Format: 


Format: 


ct HSahostname 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 


ct IN*ln 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command. 


hostname Specifies the name of the host to 
which you want your terminal con¬ 
nected. The valid entries appear 
In the HAD. 


la Specifies the Input device and 

transmission mode. You can 
specify the following values for 
In: 
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Description 


in Description 

BK Selects block mode 

as from a form ter¬ 

minal and normalized 
input mode. 

KB Selects a keyboard 

in character or line 
mode and normalized 
input mode* 

PT Selects paper tape 

and normalized input 
mode* 

X Selects the current 

input device and 
transparent input 
mode* 

XK Selects the keyboard 

and transparent in¬ 
put mode* 

XP Selects paper tape 

and transparent input 
mode* 

When the IN value is XK, XP, or X, terminal input Is 
sent to the host in transparent mode blocks* Trans¬ 
parent mode continues until the system encounters a 
previously defined transparent mode terminator* 

When the IN value is XK and transparent mode ter¬ 

minates, the IN value automatically reverts to KB* 
When the IN value is XP and transparent mode ter¬ 

minates, the IN value automatically reverts to PT* 
When the IN value is X and transparent mode ter¬ 

minates, the IN value automatically reverts to the 
value that was previously in effect* 

When the IN value is PT or XP, the network sends the 
X-ON code to start the paper tape reader automat¬ 
ically after the end of a message is output to the 
terminal and the message empties the terminal's 
output queue* 

The IN command is not applicable to HASP, 3270 or 
bisynchronous 2780 and 3780 terminals* 2741 ter¬ 

minals can only select IN-KB, IN-X, and IN-XK. Mode 
4 terminals, which are always in block mode, and 
X*25 PSN terminals cannot select PT or XP mode* 


(U) . LINE FEED IDLE COUNT 

The LI command specifies the number of idle 
characters to be inserted into the output stream 
following a line feed* 

Format: 

ct LI**value 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command* 


Parameter 


value Specifies the new line feed idle 

count* This value can be from 0 
to 99 or the string CA* A value 
of CA restores the line feed idle 
count to the default value* 

The line feed idle count is similar to the carriage 
return idle count (Cl), except that the idle char¬ 
acters are output after a line feed instead of after 
the carriage return* 

This command only applies to asynchronous terminals* 


(LK) - LOCKOUT OF UNSOLICITED MESSAGES 

The LK command determines whether unsolicited mes¬ 
sages from the network operator appear at your ter¬ 
minal* 

Format: 


ct LK«option 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command* 


option Specifies whether to lock out 
unsolicited messages* A value 
of T locks out the messages and 
a value of N allows the messages 
to appear* 

This command is not valid for bisynchronous 2780 and 
3780 terminals* 


(MS) . MESSAGE TO NETWORK OPERATOR 

The MS command sends a message to the network 
operator* 


Format; 


ct MS^message 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition cotomand* 


message Specifies your message to the 
operator* You can use any 
string of 50 characters or less* 

If you are having problems with the network (such as 
difficulty connecting to lAF), you can communicate 
these problems to the network operator using the MS 
command * 
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(OC) - FLOW CONTROL FOR OUTPUT DEVICES 

The OC command specifies whether the terminal gen¬ 
erates DC3s as a stop signal to the network and DC Is 
as a resume signal for terminal output. 

Format: 

ct OC«optlon 

Parameter Description 


ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

option Specifies whether to enable (Y) 

or disable (N) output control. 


(PA) - PARITY PROCESSING 

The PA command specifies the parity processing to be 
performed by the network. 

Format: 

ct PA»pa 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

pa Specifies the type of parity pro¬ 
cessing. You can specify the 

following values for pa: 


If the network receives a DC3 while output control 
is enabled, it suspends output until it receives a 
DCl or until you send another block of input. 

Output control applies to asynchronous terminals, 
including paper tape devices (except 2741s). 


(OP) • OUTPUT DEVICE SELECTION 

The OP command specifies the type of output device. 

Format: 

ct OP*op 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal 
definition command. 

op Specifies the output device. 

You can specify the following 
values for op: 


op 

Description 

DI 

Specifies a display 


device. 

PR 

Specifies a printer. 

PT 

Specifies a paper 


tape punch. 


You can punch a tape in any mode, but the network 
does not provide the proper X-OFF characters unless 
OP has a value of PT. 

If you select OP-PR, the network does line folding 
and page bounding for asynchronous and X.25 PSN 
terminals. If OP*»DI, the network assumes the ter¬ 
minal performs these functions itself. 

This command only applies to asynchronous terminals 
(except 2741s). OP»PT does not apply to X.25 PSN 
terminals. 


pa Description 

B Set parity bit for 

even parity during 
output, and check 
for even parity and 
set parity bit to 
zero on input. 

N In transparent mode, 

do not set or check 
the parity bit be¬ 
cause it is part of 
the input or output 
data. In normalized 
mode, set the parity 
bit to zero on input 
and output. 


0 

Set 

parity bit 

for 


odd 

parity during 


output, and check 


for 

odd parity 

and 


set 

parity bit 

to 


zero 

on input. 


Z 

Set 

parity bit 

to 


zero 

on output 

and 


check parity 

bit 


against zero 

on 


input. 

I In transparent mode, 

do not set or check 
the parity bit be¬ 
cause it is part of 
the input or output 
data. Ignore the 

parity bit when 

checking for trans¬ 
parent input mode 

delimiters. In nor¬ 
malized mode, set the 
parity bit to zero 
on input and output. 

This command only applies to asynchronous terminals 
(except 2741s). For X.25 PSN terminals, the parity 
bit is set to 0 and not checked for input. 
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(PG) - PAGE WAITING 


Parameter 


Description 


The PG command enables or disables page waiting at 
the terminal during output* If you enable page 
waiting, the terminal stops at the end of each 
output page for your acknowledgement (a null Input 
line) before output continues* 

Format: 


ct PG*optlon 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command* 

option Specifies whether to enable (Y) 

or disable (N) page waiting* 

When you enter a null Input line to get the next 
page of output, the null Input line has no other 
meaning* 

Page waiting does not apply to bisynchronous 2780 or 
3780 terminals or to HASP terminals* 


(PL) . PAGE LENGTH 

The PL command establishes the maximum number of 
physical lines that can be printed as one page* If 
OP has a value of PR, the network automatically 
positions the carriage to the top of the form after 
PL lines have been output* 

Format: 

ct PL*pl 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command* 

pi Specifies the page length* You 

can specify 0 or any value from 
8 to 255* PL-0 selects an in¬ 
finitely long page* 

The PL value must be nonzero if you want to enable 
page waiting, since page waiting only occurs after 
the number of lines defined by pl-l are output* 


(PW). PAGE WIDTH 

The PW command establishes the maximum number of 
characters that the terminal prints on one output 
line* If OP has the value PR, the system automat¬ 
ically starts a new line after pw characters have 
been output* 

Format: 

ct PW-pw 


ct Represents the network control 

character for your terminal as 

defined by the CT terminal def¬ 
inition command* 

pw Specifies the page width* You 

can specify a value of 0 or any 
value from 20 to 255* PW-0 

selects an Infinitely long line* 


(SE) . SPECIAL EDITING MODE 

The SE command enables or disables the special 
editing variant of normalized Input mode* 

Format: 

ct SE-optlon 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command* 

option Enables (Y) or disables (W) 

special editing operations* 

When special editing Is In effect, any backspace 
character entered Is stored for transmission to the 
host* Similarly, a line feed entry produces a 
normal line feed operation at the terminal and the 
network stores the line feed character code for 
transmission to the host* A backspace followed by a 
line feed causes the system to output a bell and an 
exclamation point on an ASCII terminal or an in¬ 
verted caret (v) on an APL terminal below the last 
character entered* 

This command Is only valid for asynchronous ter¬ 
minals but not for X*25 PSN terminals* 


(TC) - TERMINAL CUSS COMMAND 

The TC command specifies a terminal class for your 
terminal* The terminal class associates your 
terminal with a predefined set of terminal 
characteristics* To effectively use a terminal 
class, choose a terminal class whose default 
terminal definition corresponds to the 
characteristics of your terminal* 

Format: 


ct TC-tc 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command* 


tc Specifies the terminal class* 

The value tc can be from 1 to 17* 
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Parameter 


Description 


The following list associates terminal class values 
with terminal types: 

tc Tenainal Type 

1 M33, M35, M37, M38 teletypes 

2 CDC 713-10, 722, 751-1, 752, 756 

3 CDC 721 

4 IBM 2741 

5 M40 teletypes 

6 Hazeltlne 2000 

7 Terminals conforming to the ANSI 

X3.64 standard (DEC VTIOO) 

8 Tektronix 4010, 4014 

9 HASP protocol, postprint format 
control 

10 200 User Terminal 

11 CDC 714-30 

12 CDC 711-10 

13 CDC 714-10/20 


ct Represents the network control 

character for your terminal as 
defined by the CT command. 

You can use the TM command if your application does 
not respond to your input. The system responds to 
the TM command in the following manner: 

host status CONTROL CHARACTER=ct 

had 

prompt 

The variable items have the following descriptions: 

Item Description 

host status Indicates the status of the host 
you have just specified or to 
which you are/were connected. 
You can get any one of the fol¬ 
lowing messages; 

HOST AVAILABLE 
HOST BUSY 
HOST CONNECTED 
HOST DISCONNECTED 
HOST UNAVAILABLE 
NO HOST AVAILABLE 
NO HOST CONNECTED 
NO HOST SELECTED 


14 

HASP protocol, 
control 

preprint format 

15 

COC 734, 731-12, 

732-12 

16 

IBM 2780 


17 

IBM 3780 


18 

IBM 3270 



A terminal that is not shown as belonging to a ter¬ 
minal class may still be operational. The terminal 
can be assigned to a terminal class having similar 
characteristics and the terminal's definition can be 
modified as necessary to correctly define the opera¬ 
tional characteristics of the terminal. 

If your terminal is on an auto-recognition line and 
its terminal class is other than I, 4, 10, or 13, 
you can use the TC command to change its terminal 
class to ensure proper operation. 

If you include a TC command in a sequence of ter¬ 
minal definition commands, enter the TC command 
first as It resets all other terminal character¬ 
istics. 


(TM) . TERMINATING A TERMINAUHOST CONNEatON 

The TM command severs the connection between your 
terminal and a host. 

Format: 

ct TM 


ct Represents the network control 

character for your terminal as 
defined by the CT command. 

had Represents the host availability 

display (HAD). The HAD appears 
only if you have enabled its 
automatic display (refer to the 
HD command). 

prompt Represents an action the system 

wants you to take or a status 

message. You can get any one of 
the following prompts: 

ENTER ct HD TO SEE HOST 
STATUS 

ENTER ct HN=NN TO SELEa HOST 
ENTER INPUT TO CONNECT TO 
HOST 

INPUT DISCARDED 
READY FOR INPUT 
TERMINAL DISABLED BY NOP 


(XL) • MULTIMESSAGE TRANSPARENT MODE 

The network provides a transparent mode that allows 
you to remain in transparent input mode even after 
message blocks have been forwarded to the applica¬ 
tion. The XL command specifies the multimessage¬ 
forwarding signal and the terminator for transparent 
input mode. If your terminal's parity is set to 
even, odd, or zero (PA-B, 0 or Z), the parity bit is 
stripped (set to zero) before the characters are 
sent to the host, although no translation occurs. 
If your terminal's parity is set to none or Ignore 
(PA*N or I), the parity bit is not stripped. See 
the NAM/CCP Terminal Interfaces Reference manual for 
more information on transparent input and parity. 
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Format: 


Parameter 


Description 


ct XL»Xxx,Ccount,TO,Yyy 

Parameter Description 

ct Represents the network control 

character for your terminal as 
defined by the CT terminal def¬ 
inition command. 

Xxx Selects the character with the 

two-digit hexadecimal represen¬ 
tation XX as the message forward¬ 
ing signal. If you do not 
specify a value yy, the occur¬ 
rence of two successive charac¬ 
ters defined by xx acts as a ter¬ 
minator for transparent Input 
mode* VThen you specify a hexa¬ 
decimal code above 7F, you must 
have previously set your ter¬ 
minal ''s parity to none (PA»N) or 
Ignore (PA-I); otherwise the net¬ 
work cannot detect the code when 
It occurs In a transparent mode 
message. 


tatlon yy as a terminator for 

transparent Input mode when It 
follows XX. When you specify a 
hexadecimal code above 7F, you 
must have previously set your 

terminal's parity to none (PA»N) 
or ignore (PA-I); otherwise the 

network cannot detect the code 
when It occurs In a transparent 
mode message. 

Yyy, If specified, must follow the Xxx parameter; 

otherwise. It Is Ignored. The parameters are 
otherwise order-independent. You must specify at 
least one of Xxx or TO to select a transparent mode 
terminator. When It Immediately follows the 

character defined by Xxx on input, the character 
defined by yy terminates transparent Input mode. 
The characters defined by Xxx and Yyy can be 
identical or you can omit Yyy. In either case, two 
successive Input characters defined by Xxx are 
required to terminate transparent mode. 

The message-forwarding signals and mode terminators 
are not sent to the host. 


Ccount 


TO 


Yyy 


Selects a decimal value from I 
to 4095t as a character count 
that functions as a message¬ 
forwarding signal. 

Selects timeout as a transparent 
Input mode terminator. 

Selects the character with the 
two-digit hexadecimal represen- 


Thls command cancels all transparent mode termina¬ 
tors and delimiters defined by the Dt command or a 
previous XL command* You can select multimessage 
transparent Input mode by using the XL command in 
conjunction with the IN command and selecting IN«X, 
IN-XK, or IN-XP. 

This command does not apply to HASP and bisynchro¬ 
nous terminals* 


tThese values are valid with the network. However, unless changed during Installation, the maximum logical 
Input line length In lAF (160 characters) limits you. 
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Table G-U Default Terminal Definitions 




Terainal Typaa 





Kaa- 

aooie 

Oaaerlptloa 

TIT 

H33 

COC 

713-10, 

722,7Sl-l. 

732.796 

CDC ! 
'"1 

ISM 

2741 

TTY 

M40-2 

RAZ 

2000 

X3.64 

occ 

VTIOO 

— 

Tak 

4000 

X.29 

any 

RASP 

POST 

COC 

200 

OT 

CDC 

714-10 

COC 

711-10 

■ajc 

714-10, 

714-20 

HASP 

PRC 

COC 

734 

IBM ! 
2780 

IBM 

3780 

ISM 

3270 

TC 

Tarainal claaa 

1 

2 

3 

4 

9 

6 

7 

s 

(0) 

9 

to 

U 

12 

13 

14 

19 

16 

17 

IS 

A1 

Abort output block 

CAB 

CAB 

CAB 

( 

CAB 

CAB 

CAN 

CAM 

na 

oa 

na 

na 

na 

na 

QC 

na 

na 

na 

na 

V 

Slocklttg factor 

1 

1 

1 

1 

1 

1 

1 

1 

(1) 

oa 

1 

1 

1 

1 

no 


na 

oa 

1 

BS 

lacfctpaco eharactor 

ts 

IS 

13 

ts 

none 

8S 

ts 

BS 

(1) 

na 

na 

na 

na 

oa 

oa 

na 

na 

aa 

na 

tl 

Oaor break 1 

OU 

OLE 

OU 

: 

OU 

OU 

OU 

OU 

(1) 


: 

X 

: 

1 

* 

: 

na 

na 

5(6) 

12 

Caor brock 2 

DC4 

OCA 

DC4 

) 

ac4 

OCA 

OCA 

OCA 

(I) 

) 

) 

) 

) 

) 

> 

) 

na 

oa 

)<7) 

n 

track cc oacr brock 1 
(cod ccocol charceccr) 

N 

N 

N 

oa 

N 

N 

s 

M 

<l> 

na 

na 

na 

na 

na 

na 

na 

M 

oa 

na 

Cl 

Ccrrlcgo rocun tdlca 

2 

0 

0 

8 

1 

0 

0 

0 

(1) 

TIA 

na 

na 

na 

na 

na 

na 

na 

aa 


CM 

CcacoL clurcetor 

CAB 

CAM 

CAB 

( 

CAB 

CAN 

CAB 

CAM 

(1) 

1 

( 

1 

( 

( 

< 

{ 

na 

na 

< 

Cf 

Curaor pooltloalitt 

T 

T 

Y 

na 

Y 

Y 

T 

Y 

B 

na 

na 

na 

na 

na 

na 

na 

nc 

na 

na 

ct 

Bccwotk eeatrol 
ehcractar 

CSC 

BSC 

CSC 

2 

BSC 

ISC 

BSC 

X 

(1) 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 1 

1 

OL 

SlQglr-accacfo treae* 
perottt lepttt aotfo 





















Cbcrcctor dollalcar 

CR 

O 

Ck 

NL 

Ct 

Ct 

CB 

Cl 

(t> 

na 

(4) 

<*) 

(*) 

(*) 

na 

(*) 

na 

“ 

na 1 


Cbcrcccor ecainc 
dollaitor 

2043 

2043 

2043 

na 

2043 

2043 

2043 

2043 

(1) 

oa 

na 

na 

na 

oa 

oa 

ra 

na 

na 

fUl 


Ttaaout dollaltcr 

No 

No 

No 

aa 

So 

Bo 

No 

No 

(U 

na 

“ 

na 

na 

oa 

na 

na 

na 

oa 

ru 

IS 

eog*oe'bloek 





















Cbcrector 

COT 

COT 

tor 

na 

EOT 

COT 

COT 

EOT 

(2) 

na 

(*) 

(*> 

<*> 

<*) 

na 

(6> 

na 

aa 

na 


Curaor poatclonlng 

a 

CL 

CL 

oa 

CL 

CL 

CL 

CL 

No 

na 

No 

No 

No 

No 

na 

Me 

oa 

oa 

oa 

CL 

Cod^f‘'logical lino 





















Cbcrcctor 

CB 

Ct 

ct 

BL 

Ct 

Ct 

Ct 

Ct 

(1) 

na 

<9) 

<9> 

(9) 

(9) 

na 

(9) 

na 

na 

na 


Cutoor poaitleoleg 

LP 

Lf 

LP 

no 

u 

u 

U 

U 

No 

oa 

No 

No 

No 

Mo 

na 

Bo 

na 

na 

na 

CP 

CchopUc aodm 

N 

N 

N 

oa 

M 

N 

t 

M 

oa 

na 

na 

na 

na 

na 

na 

na 

oa 

na 

na 

PA 

Pull ASCII Input aodo 

N 

N 

N 

B 

N 

N 

H 

N 

N 

na 

N 

N 

N 

N 

oa 

N 

na 

na 

na 

1C 

Input device flow 
coaerol 

N 

ff 

M 

08 

B 

B 

Y 

N 

na 

na 

na 

na 

na 

oa 

na 

na 

na 

na 

na 

IB 

Input dovtca 

Kg 

KS 

Cl 

Cl 

Ct 

KI 

KB 

Ct 

K 

oa 

nt 

SC 

It 

tx 

na 

BX 

na 

na 

Kl 

LI 

Lioa food Idloo 

1 

0 

0 

1 

3 

3 

0 

0 

(1) 

na 

na 

na 

08 

« 

na 

oa 

oa 

oa 

na 

U 

Lodiout NOP oaoMgoa 

N 

B 

N 

M 

B 

N 

N 

N 

11) 

No 

No 

No 

No 

No 

No 

Ho 

na 

na 

B 

OC 

Output doviet flov 
control 

N 

N 


na 

N 

N 

Y 

N 

na 

na 

oa 

na 

na 

na 

na 

na 

na 

oa 

na 

OP 

Output device 

Pt 

Ot 

01 

Pt 

01 

01 

01 

01 

(1) 

na 

na 

na 

na 

na 

oa 

na 

aa 

na 

na 

PA 

Parity proeoaalng 

C 

c 

e 

na 

c 

s 

e 

c 

(3) 

aa 

na 

na 

na 

na 

na 

na . 

na 

aa 

oa 

PC 

Pago Halting 

M 

M 

M 

N 

B 

H 

N 

N 

(1) 

na 

T 

Y 

Y 

Y 

aa 

T 

na 

na 

Y 

PL 

Pago length 

0 

24 

30 

0 

24 

27 

24 

39 

(1) 

0 

13 

16 

16 

16 

0 

13 

0 

0 

24 

PW 

Pago width 

72 

so 

so 

132 

80 

74 

so 

74 

(1) 

so 

80 

SO 

SO 

SO 

so 

SO 

SO 

120 

so 

SC 

Special editing aodo 

N 

M 

N 

N 

H 

N 

N 

N 

na 

na 

na 

na 

« 

na 

na 

na 

na 

na 

na 

XL 

Nulctacaaago 

tranaparent Input node 

No 

No 

Nn 

No 

No 

No 

No 

No 

No 

na 

No 

Ho 

No 

No 

na 

No 

na 

na 

na 


(0> T^rsiiwU belong to corvtul elas*«« I tbroagh 3 or ) tbroagh 8* 

(1) Smo «s for cho ccralCMt If tc «*oro not eonnoctod «1« a pacbac*awttehlng natwort. 

(1) Kad>of>packaC aa^uanca (H bit la raa#« to taro). 

(3) Tba parley blc la tgoorad oa Input and la gatiaracad for ooCpuc aa for tha baate Carmloal cypa. 
(4> ETX (racttleiRg froa eba SENO bay). 

(3) esc A (raaultlng froa cha CAUtUCC RXTVWI kay>. 

(6) Prograa accancton kay I la a aalW uaor break I. 

(7) frograa actaatloa key Z la a aalld uaar break 2«__ 
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Table G-2. Parameter Ranges for Terminal Definition Commands (Sheet I of 2) 







Teralnal Types | 

Nee- 


m 

CDC 

coc 

im 

TTY 

HAZ 

X3.64 

Tek 

X*25 

HASP 

CX 

CX 

CX 

CX 

HASP 

CX 

IBM 

IBM 

IBM 

aonl( 

Deacrlpcioo 

H33 

713-10, 

721 

2741 

K40-2 

2000 

DEC 

4000 

any 

POST 

200 

714-30 

711-10 

714-10 

PRC 

734 

2780 

3780 

3270 




722,751-1, 





VTIOO 



in 



714-20 




752,756 

















TC 

Tenlnal class 

1 

2 

3 

4 

5 

6 

7 

8 

(0) 

9 

10 

11 

12 

13 

14 

IS 

16 

17 

18 

AB 

Abort output block 

(1) 

(1) 

(1) 

(1) 

(1) 

(I) 

<0 

(1) 

na 

na 

M 

na 

na 

oa 

na 

na 

na 

na 

oa 

BF 

Blocking factor 

0-2 

0-2 

0-2 

0-2 

0-2 

0-2 

0-2 

0-2 

(2) 

n. 

0-2 

0-2 

0-2 

0-2 

oa 

0-2 

na 

na 

0-2 

BS 

Baekapaco character 

<l> 

(1) 

(1) 

(1) 

(0,(7) 

(1) 

(1) 

(1) 

(2) 

na 

na 

na 

na 

na 

na 

na 

na 

na 

oa 

B1 

User break t 

(1) 

(1) 

<U 

(1) 

<n 

(1) 

<1) 

(l> 

(2) 

(1) 

(1) 

(1) 

(1) 

(1) 

(1) 

(1) 

na 

na 

(1) 

B2 

User break 2 

(1) 

(1) 

(1) 

(1) 

<l> 

<1> 

<1> 

(1) 

(2) 

(1) 

(1) 

(1> 

(1) 

(1) 

(1) 

(1) 

oa 

na 

(1) 

BR 

Break as usar break 1 

¥,N 

¥,N 

¥,N 

ns 

Y,H 

Y,H 

Y,H 

Y.N 

(2) 

na 

na 

na 

na 

na 

na 

na 

na 

na 

na 


(sod cenesl charsetsr) 

<¥.M) 

(t,N) 

(Y.H) 

OS 

(Y,N) 

(Y.N) 

(Y,N) 

(Y.N) 

na 











Cl 

Carrlsgs rstum Idles 

0-99, 

0-99, 

0-99, 

0-99, 

0-99, 

0-99, 

0-99, 

0-99, 

(2) 

na 

na 

na 

oa 

na 

na 

na 

na 

na 

na 



a 

CA 

CA 

CA 

CA 

CA 

CA 

CA 












CN 

Cancsl eharactar 

(1) 

(1) 

(l> 

(1) 

(1) 

(1) 

(1) 

(1) 

(2) 

(1) 

(1) 

(1) 

(1) 

<l> 

(1) 

(1) 

na 

na 

(U 

CP 

Cursor positioning 

Y.N 

¥,» 

Y,N 

na 

Y.N 

Y.H 

Y.N 

Y.N 

(2) 

na 

na 

na 

na 

na 

na 

oa 

na 

na 

na 

CT 

Neework control 
chsrsctsr 

(I) 

(1) 

(1) 

(1) 

(!) 

(1) 

(I) 

(1) 

(2) 

(1) 

(1) 

(1) 

(1) 

(1) 

(1) 

(1) 

(1) 

(l> 

(1) 

OL 

Slngle-acsaegc 

trsnapsreat Input 
■ode 

















1 




Character dellatter 

0-PP 

0-PF 

0-rr 

6D 

O-FF 

O-FF 

0-FF 

0-FP 

(2> 

na 

03 

03 

03 

03 

1 na 

03 

na 

na 

oa 


Character count 
dellalter 

1-4095 

1-4095 

na 

na 

1-4095 

T 

s 

1-4095 

1-4095 

(2) 

na 

na 

oa 

na 

na 

na 

na 

na 

na 

oa 


Tlacoue dellalter 

TO 

TO 

TO 

na 

TO 

TO 

TO 

TO 

(2) 

na 

na 

na 

na 

na 

na 

na 

na 

na 

na 

EB 

End-of-block 





















Character 

(1). 

<l). 

(l> 

na 

(D* 

(1). 

(l>. 

(U. 

(2) 

na 

EB 

EB 

EB 

EB 

na 

EB 

na 

na 

na 



EL, 

EL, 

EL, 


EL, 

EL, 

EL, 

EL, 














EB 

EB 

EB 


EB 

EB 

EB 

EB 













cursor positioning 

(3) 

(3) 

(3) 

na 

(3) 

(3) 

(1) 

(3) 

(2) 

na 

M> 

lb 

(to 

(to 

na 

(to 

na 

oa 

na 

EL 

End-of-log leal Una 





i 
















Charccter 

(1), 

(1). 

(1). 

na 

(1). 

(1). 

(1). 

ei). 

(2) 

na 

EB, 

CB, 

EB. 

EB. 

na 

EB, 

oa 

na 

na 



EL, 

EL, 

EL, 


EL, 

EL, 

EL, 

EL, 



CL 

EL 

CL 

CL 


EL 






EB 

EB 

EB 


EB 

EB 

EB 

EB 












1 

Cursor positioning 

1_ 

<3) 

<3) 

(3) 

na 

(3) 

(3) 

(3> 

(3) 


na 

Nn 

(to 

lb 

lb 

oa 

(to 

na 

na 

na 


(0) Tcntliult b«toQ| CO ccnilMl elUMs I chrouth 3 or S chrough 8. 

(l> Any eharnetor froa tho ASCII I28ochnractor soe except «ny lowercaee or uppercase alphabetic character, any digit 0 through 9, NULL, SOH, SIX, ■, 
DEL, or apace, 

(2) Saae as for the teralnal tf It were not connected by a packec«swltehtng neework. 

(3) CX, LF, CL, NO. 

(A) KB, FT, 8K. X, XK. XP. 

(5) PR, Dl, PT. 

(6) Saae as for the teralnal If It were not connected by a packef’SwltchinK network. Parity iattorud .mi input and is acnorated for output. 

(7) ASCII BS character code (8 hcxadcclaal) cannot be used. 


• G-16 
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Table G-2. Paratneter Ranges for Terminal Definition Commands (Sheet 2 of 2) 


coc 

713-10, 

722,751-1, 

752,756 


Ttrattml Typai _ 

Ik |x.25 I HASP CDC 


CDC HASP COC IBH 
714-10, PRE 734 2780 
714-20 


IBM IBM 
3780 3270 


BP Echoplex sode t,h 

FA Full ASCII lopttC aod* Y,K 

tC Input device flow Y,N 

control 

IN Input device (4) 

LI Line feed Idlee <h9 

CA 

LX lockout aeeeeget Y,f 

OC Output device flow Y,II 

control 

OP Output device (5] 

PA Perlty proceesing Z,( 

E.N 

PC Pege waiting Y,II 

PL Pege length 0,1 

25! 

PW Page width 0,; 

255 25! 

SE Special oditleg aode Y,! . 

TC Teraloai claaa Input 1,2,3, 1,2,3, 1,2,3, 4 1*2*3, 

5-8 5-8 5-8 5-8 5-8 5-8 5-8 

XL Kuitlaeasage 

trenapareat Input 

lode 

Character dellalter O-FP O-FF <KFF 2D 0-FF (HFF 0-FF 0-FF (2) 

Character teralnator 0-FF 0-FF 0-FF 2D 0-FF 0-FF 0-FF 0-FF (2) na 

Tlaeaut del latter TO TO TO na TO 

Character count 1-4095 1-4095 1-4095 na 1-4095 

del latter 


(0) Tetainale belong to teraloai claaaee I through 3 or 5 through 8. * ^ ^ 

(1) Any elaracter fcoa the ASCII 128-cbaraccer aec except any lowercaaa or uppercaae alphabetic character, any digit 0 through 9, MILL, S0«, SIX, •, 
DEL, or apace* 

(2) Saae aa for the teraloai If It ware not connected by a peeket-awltcblng network. 

(3) a, LF, CL. m. 

<4) KB, FT. 8X. X, S. XF. 

<5) FI, DX, FT. , , 

(6) Saae aa for the terminal If It were c»e connected by a peckat-awltchlng network. Parity la Ignored on Input and la generated for output. 

(7) ASCII IS character coda (8 hexadecimal) cannot be uaed. 
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DELIMITING AND TRANSMITTING TERMINAL INPUT 


H 


You can transmit Input to an application In normal¬ 
ized mode (also called character mode) or transparent 
mode (also called binary mode). In transparent Input 
mode, the network does not convert any of your Input 
but sends It directly to your application. Charac¬ 
ters like UF and BS, which the network normally 
strips from the input stream, become part of the data 
sent to your application, i^pendlx G describes bow 
you delimit and transmit Input In transparent mode 
(refer to the DL and XL conaaands). The default Input 
mode for all supported terminal classes Is normalized 
mode, however. The remainder of this appendix 
describes how to delimit and transmit terminal input 
In normalized mode under the default conditions of 
the various terminal classes. (Appendix G also 
describes how you can change these defaults.) 


PHYSICAL END-OF-LINE (LINE FEED) 

In terminal classes 1 through 8, you can terminate a 
physical line of input with a line feed key. The 
network also terminates a physical line of output 
whenever the page width of a terminal Is reached 
(refer to the FW conmand in appendix G). The 
network may respond to the line, feed key by 
advancing the cursor or carriage to the beginning of 
the next line (refer to the CP command in appendix 
G). 

This key Is transparent to TAP. When the terminal 
Is not In block mode. It performs the same function 
as the carriage return but does not Initiate the 
transaction. Rather, It causes the message to be 


stored in the communication block chain until the 
message transmission key Is pressed. 


LOGICAL END-OF-LINE (CARRIAGE RETURN) 

You terminate a logical line of Input with a 
carriage return key. A logical line can consist of 
one or more {Aiyslcal lines but not vice versa. The 
network may respond to the carriage return by 
advancing the cursor or carriage to the next line 
(refer to the EL command In appendix G). 


MESSAGE TRANSMISSION 

You transmit your Input to the network with the 

message transmission key. For non-blockmode devices, 
the message transmission key Is the carriage return 
key. Renee, for these terminal classes, logical 
lines are transmitted separately. When the 
delimiter for the logical end-of-line and 
transmission key are different (as with block mode 
devices. Including PSN and mode 4 terminals), the 

terminal stores logical lines until you press the 
transmission key. It then sends the single 

transmission consisting of multiple logical lines to 
the network. The network sends each logical line 

separately to your application. 

Table H-1 shows the keys used by the various 
terminal classes to perform the three functions just 
described. 
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Table H-*!. Default Message Delimiter and Transmission Keys 


Terminal Class 

Function 

Physical End-of- 
Llne (Line Feed) 

Logical End-of-Line 
(Carriage Return) 

Message 

Transmission Key 

1 

LINE FEED 

RETURN 

RETURN 

2 

1 

RETURN 

RETURNt 

4 

ATTN 

RETURN 

RETURN 

5 

NEW LINE 

RETURN 

RETURN 

6 

LF 

CR 

CR 

7 

LINE FEED 

CARRIAGE RETURN 

CARRIAGE RETURN 

8 

LF 

RETURN 

RETURN 

9 

Varies tt 

Variestt 

Varlestt 

10 

None 

RETURN 

SEND 

i 

None 

RETURN 

SEND 

12 

None 

NEW LINE 

ETX 

13 

None 

NEW LINE 

ETX 

14 

Varlestt 

Varlestt 

Varlestt 

15 

None 

NEW LINE 

SEND 

16 

None 

EM 

EOT 

17 

None 

EH 

EOT 

18 

None 

Varies 

ENTER 


tif in block mode, refer to terminal documentation for terminal key equivalences* 
Those listed are for character and line modes* 
ttTerminals operating under HASP protocol use different keys for this purpose* 


H-2 
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DETECTION OF POTENTIALLY BLOCKED TASKS 


I 


TAF prevents situations from occuring in which the 
execution of a task is blocked because it is 
Impossible under the circumstances to obtain the 
needed central memory space for the task, whether 
for an initial load or a memory increase. Several 
terms will be defined to aid in the description of 
how potentially blocked tasks are detected: 

• Minimum size of the total task area 

The total task area is the CM in which TAF 
will schedule tasks. It includes the space 
occupied by CM-^resident tasks. The area 
extends from the first word address into 
which tasks can be loaded to the maximtim 
field length of TAF. The size of this area 
fluctuates if the TAF/CBM Data Manager is 
used. The minimum size of this area occurs 
when the TAF/CRM buffer takes on its maximum 
size. 

• Minimum size of the transient task area 

The transient task area is that portion of 
the total task area not occupied by 
CM^resident tasks. The minimum size of this 
area is defined to be the minimum size of 
the total task area minus the sum of the 
MFLs of all CM-resident tasks. 

One or more Casks will be considered to be 
potentially blocked under the following 
circumstances. 


• If the initial field lengths of the 
CM-resident tasks are so large that they all 
couldn not be loaded together. 

• If the sum of the MFLs for the CM-resident 

tasks exceeds the minimum size of the total 
task area. 

• If the MFL of a non-CM-resldent task exceeds 
the minimum size of the transient task area. 

Following are the situations when potentially 
blocked tasks are detected and the actions that are 
taken. 

• At TAF initialization. Potentially blocked 

tasks result in TAF being aborted. 

• When TAF is Informed, via the LIBTASK TT 

option, of the update of a Cask library 

attached by TAF and the library contains 
potentially blocked tasks, the update will 
be rejected. 

• When an attempt is made to reduce the MFL of 

TAF via Che K.MAXFL command to a value that 
results in potentially blocked tasks, the 

command will be rejected* 

The preceding checking assumes that the maximum 
field length of TAF is set (by default, via K.MFL, 
or via K.MAXFL commands) to a value that can be 
attained. 


I-l 
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ACCESSING A HOST 


J 


This appendix describes Che steps used to access a 
host and to use CDC network software. The login 
procedure can be divided into eight steps. 

• Gathering information. 

• Setting up your terminal. 

• Connecting your terminal to the network. 

• Identifying your terminal to the network. 

• Selecting a host. 

• Connecting to the selected host. 

• Identifying yourself and your terminal to 
the host. 

• Selecting a network application. 

The first part of this appendix gives a brief 
description of the eight steps. The second part of 
Che appendix gives a more detailed description of 
Che same eight steps followed by additional general 
information. You may find the brief description of 
the steps sufficient to accomplish login at your 
site. If not. consult the detailed description. In 
addition to more detail, it provides shortcuts, the 
various options that are available at any given 
step, and failure conditions* 


BRIEF DESCRIPTION OF ACCESS 

STEP 1 • GATHERING INFORMATION 

Find the answers to the following questions. 

• Is your terminal hardwired to the system? 

• Which key is the data transmission key for 
your terminal? 

• If you have a dialup terminal, what telephone 
number must you dial? 

• Into which of the following categories does 
your terminal fall? 


Asynchronous terminals 

Asynchronous terminals using X.25 
protocol 

CDC mode 4 synchronous terminals 
Houston Automatic Spooling Program 
(HASP) terminals 

Bisynchronous terminals like IBM 
2780/3780 

Bisynchronous terminals like IBM 3270 

• Must you supply a family name, user name, 
password, and application name during login? 
If so, get the required information. 

• Does your terminal use the ASCII character 
set and code? 


STEP 2 • SETTING UP YOUR TERMINAL 

• Turn power switch on. 

• Load and Initialize any software or control- 
ware needed by your terminal* 

• Set the terminal's duplex or echoplex switch 
to the correct position (typically HALF if 
your keyboard entries appear unduplicated on 
your console's screen or printer). 

• Set the terminal's parity switch to its 

proper position. 

• Set the line speed switch to its proper 

setting. 

• Set the transmission mode to either the 

character or line mode position. 

• Set the online/offline switch to the online 
position. 


STEP 3 • CONNECTING YOUR TERMINAL TO THE NETWORK 

Skip this step if your terminal is hardwired. 
Otherwise, determine which of the configurations in 
figures J-l, J-2, J-3, and J-4 most closely matches 
your terminal and follow the instructions in the 
figure. 
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1. Turn on coupler. 

2. Pick up receiver. 

3. Dial phone number. 

4. Wait for high-pitched tone. 

5. Fit receiver Into coupler. Be 
sure you put the cord end of 
the receiver into the correct 
cup, as indicated on the 
coupler. 



Figure J-1. Separate Acoustic Coupler 


L. Pick up receiver. 

2. Push button, such as 0RI6 but¬ 
ton on Teletype model 33 or 35. 

3. Dial phone number. 

4. Wait for high-pitched tone. 

5. Push button, such as ORIG but¬ 
ton on Teletype model 33 or 35. 

6. Replace receiver. 


□ 

QD 

o 

o 

o 

o 

o 

o 

a 

o 




Figure J-2. Data Set Built Into the Terminal 


1. Pick up receiver. 

2. Set switch to TALK or push TALK 
button. 

3. Dial phone number. 

4. Wait for high-pitched tone. 

5. Set switch to DATA or push DATA 
button. 

6. Replace receiver. 




Figure J-3. Data Sets with Switches and Buttons 


J-2 
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I« pick up receiver. 

2* Dial phone number. 

3* Walt for high-pitched tone. 

4* Fit receiver into coupler. Be 
sure you put the cord end of 
the receiver into the correct 
cup, as indicated on the 
coupler. 



Figure J-4. Terminal with Built-in Acoustic Coupler 


STEP 4 . IDENTIFYING YOUR TERMINAL TO THE NETWORK 

If the network does not prompt you within a few 
seconds after you are connected to it (there might 
be a light on the terminal that indicates when your 
terminal is connected), perform the appropriate 
following steps. 

• For asynchronous terminals not using X.25 
protocol: 

a. Press the key that transmits a carriage 
return. The network responds with two 
line feeds when it recognizes your line 
speed. 

b. Type a closing parenthesis (not required 
if the terminal uses the ASCII character 
set and code) and press the carriage 
return key. When the network recognizes 
your character code set, it responds 
with a line feed. 

• For asynchronous terminals using X.25 

protocol; 

Get the information from your site. 

• For mode 4 synchronous terminals: 

Press the data transmission key. 

• For HASP and 2780/3780 bisynchronous 

terminals: 

Send a /^CONFIG card Image. 


• For 3270 bisynchronous terminals: 

No identification is necessary. 


STEP S • SELECTING A HOST 

If you have a choice of hosts or host paths (multi¬ 
host), the network displays a list of the hosts and 
host paths that are available and prompts you to 
make a selection. Otherwise, you can enter: 

ct HD 

to get a list of hosts, ct is your terminal's net¬ 
work control character (refer to the NOS Reference 
Set, Volume 3, System Commands). 

Make your selection with one of the following 
commands. 

ct HN=node 
or 

ct HS^^hostname 

node Is the number of a host path; and hostname is 
the name of a host. 


STEP 6 - CONNECTING TO THE SELECTED HOST 

If your terminal was not automatically connected to 
a host, the network prompts you to connect. Enter a 
carriage return to make the connection. 
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STEP 7 - IDENTIFYING YOURSELF AND YOUR TERMINAL TO 
THE HOST 

Once your terminal Is connected to the host, the host 
displays a banner similar to: 

WELCOME TO THE NOS SOFTWARE SYSTEM, 

COPYRIGHT CONTROL DATA 1978^ 198X. 

date time terminal name 

site identification NOS 2 PSR Level number 

Follovlng this banner, you may be prompted for a 
family name, then a user name, then a password, and 
finally an application name (If there Is no 
default). For each prompt, enter the appropriate 
information followed by a carriage return. 


STEP 8 - SELECTING A NETWORK APPLICATION 

If your login is successful, your terminal is placed 
under the control of the requested or default 
application, which then prompts you for a command. 


DETAILED DESCRIPTION OF ACCESS 

The following description covers in more detail the 
eight steps briefly described earlier. Although each 
of the steps is always performed when a terminal 
accesses the system, you might find that your net¬ 
work's administrators can make many of these steps 
unnecessary by having the software perform the steps 
for you. 


STEP ] . GATHERING INFORMATION 

If you know the answers to the following questions, 
or can get the answers from people at your site, the 
text following each question will tell you which 
steps and corresponding subsections of this appendix 
you can skip. If you cannot answer the questions, 
read all of the subsections; each procedure 
description contains hints for answering the 
questions. 

1. Is the terminal hardwired, or is it a dial¬ 
up terminal? 

A hardwired terminal Is connected directly 
to the network through a device called a 
modulator/demodulator (modem). A modem can 
be either a separate box, or built into the 
terminal. A dial-up terminal temporarily 
connects to the network through a telephone 
line and either an acoustic coupler or a 
telephone data set (a coupler or data set 
does the same things as a modem). 

If you do not need to dial a telephone number 
to use the network, then your terminal is 
hardwired. (A nearby telephone does not ne¬ 
cessarily mean the terminal Is dial-up.) 

2. Is your network configured for automatic 
recognition? 


J-4 


Your site can ask the network software to 
determine certain things about your terminal 
when the terminal joins the network. This 
process is called automatic recognition. 
[Terminals using X.25 packet-switching net¬ 
works (PSN) cannot use automatic recogni¬ 
tion.] 

If your network is configured for automatic 
recognition, you must perform an extra step 
each time you connect your terminal to the 
network. If your terminal is not so con¬ 
figured, you may skip questions 3 and 4. 

3. What protocol does your terminal use? 

Your terminal must fit into one of the 
following categories. 

• Asynchronous terminals chat work like 

teletypewriters or IBM 2741 ter¬ 

minals. 

• Asynchronous using an X.25 PSN 

through a packet assembly/disassembly 
(PAD) service; these terminals work 
like teletypewriters. 

• CDC mode 4 synchronous; mode 4A ter¬ 

minals work like the CDC 200 User 
Terminal, while mode 4C terminals 
work like CDC 711 or 714 terminals. 

• HASP terminals. 

• Bisynchronous terminals that work 

like IBM 2780, 3270 or 3780 ter¬ 

minals . 

If your terminal operating manual does not 
tell you what protocol your terminal uses, 
question 4 and Che terminal classes shown in 
the NOS Reference Set, Volume 3, System Com¬ 
mands might help you answer this question. 
If your network is not configured for auto¬ 
matic recognition, skip question 4. 

4. What class of terminal is it? 

Many different kinds of terminals exist. 
The network software assigns terminals it 
supports to classes. If you know what the 
terminal class is, that will tell you the 
protocol, as follows: 


Class 

Protocol 

1 thru 8 

Asynchronous or X.25 

asynchronous 

9 and 14 

HASP bisynchronous 

10 and 15 

CDC mode 4A synchronous 

11 thru 13 

COC mode 4C synchronous 

16 and 17 

IBM 2780 and 3780 bi¬ 
synchronous 

18 

IBM 3270 bisynchronous 

Other 

Site-defined 
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Terolnals in classes 1 through 8 sometimes 
are called interactive terminals* A console 
has an input and output device that can be 
used for dialog with the network. Most 
consoles use a television-like screen or a 
typewriter-like mechanism to convey output 
information* Almost all consoles have a 
keyboard for entering information to the 
network* Some consoles might also use 
mechanisms such as magnetic tape cassettes 
or paper tape reader/punches for input or 
output* 


Terminals in classes 9 through 18 sometimes 
are called remote batch terminals or remote 
job entry terminals. Such terminals have an 
interactive console and can also have batch 
devices the network can use for input only 
or for output only* 

Figure J-5 shows a console with a display 
screen and a keyboard* Figure J-6 shows a 
console with a printer and a keyboard* 
Figure J-7 shows a remote batch terminal 
with a console, card reader, and a batch 
printer device* 



Figure J-5* Interactive Display Console 



Figure J-6* Interactive Printer Console 

















Figure J-7. Remoce Batch Termlaal 


5« VThat key ends a line of data? What key 

sends data? (Does the tenolnal use block 
mode?) 

You should know when data leaves your ter~ 
minal so that you know when to expect a res-- 
ponse from the network or the host computer* 
Your terminal operator's guide should tell 
you what key or keys send data from your 
terminal* 

Terminals transmit Information in one of the 
following ways* 

• A character at a time (transmission 
occurs as you enter each character)* 

• A line at a time (transmission might 
occur when you end each line)* 

• Several lines at a time, called a 
block (transmission occurs when you 
direct the terminal to transmit)* 

Terminals that send data a character at a 
time are treated by the network as if they 
sent characters a line at a time* Until you 
end the line by entering a character or set 
of characters called an end-of-llne charac¬ 
ter, you can backspace within the line and 
change data* When you enter the end-of-line 
character, the network processes the data* 


The end-of-line character used can be changed 
by you, by a site administrator, or by an 
application* We represent the end-of-line 
character for such terminals by a carriage 
return * 

This appendix assumes you enter an end-of- 
line character after each command* 

Terminals that send data a character at a 
time usually send the end-of-line character 
when you use a key called the end-of-line key 
(remember, the character can be changed)* 
The end-of-line key might be labeled CARRIAGE 
RETURN, RETURN, RET, NEWLINE, NEXT, ATTN, or 
CR* 

Terminals that transmit a line at a time 
usually send the end-of-line character and 
transmit the line when you use the end-of- 
line key* If the character is changed, then 
you must enter the character as the last 
entry on the line before pressing the end- 
of-line key* The end-of-line key might be 
labeled CARRIAGE RETURN, RETURN, RET, 
NEWLINE, NEXT, ATTN, or CR* 

Terminals that send data a block at a time 
do not transmit your data to the network 
when you press an end-of-line key* Until 
you press a key called the end-of-block key, 
you can position the cursor anywhere within 


• J-6 
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any unsent line and change data* This key 
night be labeled SEND, ETX, EOT, or XMIT. 
When you press the end-of-block key, the 
network processes each line of data as if it 
had been transmitted one line at a time* 

The network expects each block from a block 
mode terminal to end with a character or set 
of characters called the end-of-block indi¬ 
cator* The end- 0 f-block indicator used can 
be changed by you, by a site administrator, 
or by an application program* (fe do not show 
the end-of-block indicator in the examples* 

Terminals that transmit a block at a time 
usually send the end-of-block character and 
transmit all lines in the block when you use 
the end-of-block key* If the character is 
changed, then you must enter the character 
at the end of the last line before pressing 
the end-of-block key. 

Terminals that transmit blocks are sometimes 
said to work in batch mode; do not confuse 
this kind of batch mode operation with re¬ 
mote batch data transmissions* Remote batch 
data transmissions are simply transmissions 
of files from or to the host using batch de¬ 
vices, bypassing the terminal* 

6* What telephone number is appropriate? 

If your terminal is hardwired, you may skip 
questions 6 and 7* 

Your network might use a specific telephone 
number for terminals that communicate at a 
certain speed, for terminals operating in 
block mode, or for all terminals using cer¬ 
tain protocols. 

The telephone number you use determines 

whether you need to complete some of the 
procedures* If you do not know what numbers 
you should use, get help from a site admin¬ 
istrator* 

7. Is your terminal automatically connected to 
a host? 

If it is, skip question 8* 

8* What is the name or node number for the host 
you need to use? 

9* Will your terminal be automatically logged 

in? 

If so, skip question 10. 

10* What is the family name, user name, and 

password appropriate for you on the host 
system you will be using? 

You can get this information from site 
administrators* 

11* Is your terminal automatically connected to 
a network application? 

If so, you will not have to select an 

application at login. 


STEP 2 . SETTING UP YOUR TERMINAL 

If your terminal is hardwired, you can probably skip 
most of this subsection; hardwired terminals are 
usually set up once and left in the appropriate 
condition. Before using this subsection, review the 
applicable terminal operator's manual, which des¬ 
cribes the procedures for setting up your terminal. 
If you are using an X.25 terminal, follow the PAD 
access procedures supplied by the packet-switching 
network service. 

Switch settings are important* The number, type, 
settings, and names of switches vary from terminal 
to terminal* Some terminals use buttons or toggles 
for switches; others use software option selections 
as switches. 

If other people have used your terminal to connect 
to the network, the switches should be set correctly; 
do not change them. Directions for setting the 
switches may be posted near your terminal* 

Here is a suggested procedure to follow when setting 
up your terminal: 

1. Turn on the power switch* 

2. Load and initialize any software or control- 
ware needed by your terminal. You will find 
detailed Information on this task in your 
terminal^'s operator manual* 

3. Set the terminal'^s duplex or echoplex switch 
to the correct position (use HALF If you are 
not sure). If you wish to have the display 
of your login password suppressed, you must 
use full duplex* If nothing you enter 
appears on your console after you connect to 
the network, the network must display char¬ 
acters for your console. The NOS Reference 
Set, Volume 3, System Commands describes how 
to enable and disable character echoing by 
the network (refer to the EP command). 

4. Set the terminal's parity switch to the 
proper position* If garbled output appears 
at your console after you connect to the 
network, the network must use a different 
parity choice for your terminal* The NOS 
Reference Sec, Volume 3, System Commands 
describes how to change parity use by the 
network (see the PA command)* 

5* Set the line speed switch to a speed that 
matches one associated with the telephone 
numbers you were given. If you do not know 
the line speed you should use, set the 
switch to any position for X.25, mode 4 
synchronous, or bisynchronous terminals; set 
the switch to 30 characters per second (300 
bits per second) for asynchronous terminals* 

6* Set the transmission mode switch to either 
the character or line mode position (you can 
change it later if you have a block mode 
terminal)* For example: on a Viking 721, 
select the CHAR option; on a CDC 751, set 
the switch to the CHAR position; on a CDC 
200 User Terminal, set the switch to the 
LINE position* 


60459500 C 


J-7 • 



7. Set the oaline/offllne switch to the position 
that permits online communications* For ex¬ 
ample: on a Viking 721, select the ON option 
of the LINE setting; on a GDC 713, turn off 
the LOCAL Indicator switch; on a Teletype, 
set the LINE/OFF/LOCAL switch to the LINE 
position; on a CDC 200 User Terminal con¬ 
sole, set the ATTENDED/UNATTENDED switch to 
the ATTENDED position* 

You are now ready to connect your terminal to the 
network* 


STEP 3 . CONNEaiNG YOUR TERMINAL TO THE NETWORK 

To begin communication, your terminal must be 
physically connected to the network* If your 
terminal Is hardwired, skip the remainder of this 
subsection; this subsection applies only to dial-up 
terminals. 

A dial-up terminal uses either an acoustic coupler 
(asynchronous terminal) or a data set (asynchronous, 
X*25, bisynchronous, or synchronous terminal) to 
link itself to the network* 

An acoustic coupler can be built Into the terminal* 
Figure J-4 shows a terminal with a built-in acoustic 
coupler and gives directions to connect the terminal 
to the network* 

An acoustic coupler can also be separate from the 
terminal* Figure J-1 shows an acoustic coupler 
separate from a terminal and gives directions to 
connect the terminal to the network* 

A data set can be built into the terminal* Figure 
J-2 shows a terminal with a data set built In and 
gives directions to connect the terminal to the 
network* 

A stand-alone data set can have either a switch 
labeled TALK and DATA or Individual buttons labeled 
TALK and DATA* Figure J-3 shows both a data set 
with switches and a data set with buttons and gives 
directions to connect the terminal to the network. 

After you dial the phone number, either you get a 
hlgh-pltch tone or an operator answers* If an 
operator answers, ask for your terminal to be con¬ 
nected, wait for the tone, and then place the re¬ 
ceiver In the coupler or set the data set switch or 
button to the on or data position* If you get a 
busy signal, wait and redial or try another number* 

If your terminal has an Indicator (sometimes marked 
DSR, DATA SET READY, or SYSTEM ACTIVE), It lights to 
let you know that the terminal is connected to the 
network* Walt approximately 2 seconds after the 
light comes on before entering data* 

You are now ready for the next step* You might need 
to do one or all of the following: 

• Identify your terminal to an X*25 network 
(this appendix does not describe this pro¬ 
cedure). 

• Identify your terminal to the CDC network. 

• Select a host* 


• Connect to the selected host* 

• Identify yourself and your terminal to the 
host (log In). 

• Select a network application* 

The software usually sends you a message that helps 
you decide which step comes next* If nothing 
appears at your terminal within a few seconds, you 
probably need to Identify the terminal to the net* 
work* 


STEP 4 • IDENTIFYING YOUR TERMINAL TO THE NETWORK 

Once you have established physical connection to the 
network hardware, you might need to Identify the 
terminal to the network software* 

This identification procedure, called automatic 
recognition, is not always needed* It does not 
apply to X*2S terminals* It does not apply if the 
communication line used by your terminal is not 
configured for automatic recognition* 

If your terminal does not display any Information 
within a few seconds of physical connection, you 
should complete one of the Identification procedures 
described In the following subsections. The pro¬ 
cedure you use depends on the terminal protocol, 
which you can determine if you know the terminal"*s 
type and/or class. 

If you do not complete the identification procedure 
within the allowed time, the network disconnects a 
dial-up terminal* Hang up the phone and redial the 
number if you are using a dial-up terminal* You 
must restart the procedure for a hardwired terminal. 


Procedure for Asynchronous Terminals 

For an asynchronous terminal, which belongs in 
terminal classes 1 through 8, complete this pro¬ 
cedure within I minute: 

1* Walt about 2 seconds after the light that 
indicates your terminal Is connected to the 
network comes on* 

2* Press the carriage return key to identify 

the line speed used by your terminal* The 
network software responds with two line 
feeds* 

3* If your terminal uses an APL, EBCD, or cor¬ 
respondence code character set, type a 
closing parenthesis; If your terminal uses 
an ASCII character set, you need not type In 
anything* 

4* Press the carriage return key to identify 

the character and code set used by the 
terminal. The network software responds 
with a line feed. 

The software sends you a message that helps you 
decide which step comes next* Turn to the sub¬ 
section appropriate for the next step you must 
perform. 
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Procedure for HASP Terminals 


parameter 


Description 


HASP terrainals belong either to terminal class 9 or 
14• For automatic recognition of your HASP ter- 
minal, you might need to modify the signon block or 
enter a special statement* 

The first information transmitted by a HASP terminal 
after it is connected to the network is called a 
signon block* A terminal might handle signon block 
transmission in one of several ways* 

• Some terminals automatically transmit a sig- 
non block that begins with the characters: 

/*SI6N0N 

These eight characters and the information 
following them imitate the card required by 
some IBM host systems for terminal identi¬ 
fication* This transmission can occur with¬ 
out your knowledge or intervention if the 
information is built into the firmware or 
hardware* 

• Some terminals require you to enter informa¬ 
tion for the signon block before they will 
transmit anything to the network; however, 
they only allow the block to contain infor¬ 
mation beginning with the eight characters 
/*SIGNON* These characters and other infor¬ 
mation might be required as: 

-A command from the console* 

-A card read from any card reader* 


ti Terminal type: 

POST hasp postprint (de¬ 

fault); this is ter¬ 
minal class 9* 

PRE HASP preprint; this 

is ter^nal class 14* 


CO^co Configuration ordinal, a decimal 

integer from 1 to 255; the de¬ 
fault is 1* Use the configura¬ 
tion ordinal to select one of 
several terminal definitions de¬ 
fined for the line that describes 
a specific combination of addi¬ 
tional characteristics* Site ad¬ 
ministration personnel can tell 
you the correct number to use* 


CR=x 

Identifies 

available 

card 


readers* The default is I * 


LP=x 

Identifies 

available 

line 


printers* 

The default is 1 * 


CP=y 

Identifies 

available 

card 


punches; y 

cannot equal z* 

The 


default is 1. 

PL=z Identifies available plotters; y 

cannot equal z* No default 
exists for z; you cannot omit 
PL*z if you have a plotter. 


-A card read from a specific card reader* 


X, y, or z is a list of numbers specified by either: 


• Some terminals require you to enter signon 
block information before they will transmit 
anything to the network, but the content of 
Che signon block is left up to you* Whether 
the information can be entered from the con¬ 
sole or from a card reader depends on the 
terminal. 

The network software cannot use information from a 
/*SIGNON card image* When such a card image is 
received in a signon block, the signon block con¬ 
tents are discarded* 

Instead, Che network software uses a /*COMFIG state¬ 
ment for the automatic recognition procedure* You 
can send the /*COMFIG statement in the signon block 
when your terminal permits you to provide the con¬ 
tents of that block* 

If the signon block does not contain the /*COMFIG 
statement and the terminal must use automatic 
recognition, a prompt requesting that statement is 
sent to the terminal console* When a prompt for the 
statement appears, enter the statement through a 
card reader* 


The format of the /*CONFIG statement is; 

/★CONFIG,ti,CO=co^CR=x^LP=x,CP=y^PL=z 

Blanks are not allowed within the statement; a blank 
ends parameter processing. The parameters, which 
you can specify in any order, are; 


1/2/ . • • /7 
or: 

ALL (all numbers from 1 through 7) 

The numbers you use for x, y, and z must match the 
HASP stream numbers used for the corresponding de¬ 
vices within the workstation* Site administration 
personnel should have this information if you do not 
know what numbers to use* 

For example: 

/*C0NF1G,PRE,C0=2,CR=2,UP=2/3,CP=4,PL=5 

identifies your terminal as the second preprinting 
workstation defined for the communication line, 
having: 

• A card reader and line printer on stream 2* 

• Another printer on stream 3* 

• A card punch on stream 4* 

• A plotter on stream 5* 

If no prompt for a /★CONFIG statement appears, you 
are ready for the next step* 

The software sends you a message that helps you 
decide which step comes next* Turn to the 
subsection appropriate for the next step you must 
perform* 
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Procedure for Mode 4 Terminals 

Mode 4 cerminals belong Co teriolnal classes 10 
chrough 13 and 15* For auComacic recognition» press 
the end-of-block key within 1 minute of physical con¬ 
nection* 

You are ready for the next step* The software sends 
you a message that helps you decide which step comes 
next* Turn to the subsection appropriate for the 
next step you must perform* 


Procedure for Bisynchronous Terminals 

Bisynchronous terminals belong to terminal classes 
16, 17, and 18. Enter a /*C0NPIG statement to 

specify the type of terminal and the devices avail¬ 
able at it* 


The format of the /*C0NPIG statement is: 

/*C0NFIG,ti^C0=co,CR^LP^CP=y 

Blanks are not allowed within the statement; a blank 
ends parameter processing* The parameters, which you 
can specify in any order, are as follows: 


Parameter 


ti 


C0=co 


CR 

LP 


CP«y 


For example: 


Description 


Terminal type: 


2780 

IBM 2780 

(default); 


this is 

class 16* 

terminal 

3780 

IBM 3780; 

this is 


terminal class 17* 

3270 

IBM 3270; 

this is 


terminal class 18* 


The configuration ordinal, a 
decimal integer from 1 through 
255; the default is 1* Use the 
configuatlon ordinal to select 
one of several terminal defini¬ 
tions defined for the line that 
describes a specific combination 
of additional characteristics* 
Site personnel can tell you the 
correct number to use. 

Indicates an available card 
reader; assumed if not specified* 

Indicates an available line 
printer; assumed if not spe¬ 
cified* 

Indicates an available card 
punch; assumed not to exist if 
not specified* The -y portion is 
not allowed for 2780; for 3270 or 
3780, the y portion is required 
and can be either 2 or 3 to cor¬ 
respond to the device selection 
character DC2 or 0C3. 


/*C0NFIG,3780,C0=4,CR^LP,CP=2 
identifes your terminal as a 3780 terminal having: 

• A card reader and line printer* 

• A card punch, which is selected by the char¬ 
acter code DC2* 

If no prompt for a /^CONFIG statement appears, you 
are ready for the next step* 

The software expecting the next step sends you a 
message which helps you decide which procedure comes 
next* Turn to the subsection appropriate for the 
next step you must perform* 


STEP 5 • SELECTING A HOST 

You might need to select the host, which runs the 
software you want to use* This is not necessary if 
your Installation personnel select a host path for 
your terminal when the network is configured* 

You can select or change a site-defined host path 
after you connect your terminal to the network* The 
host path selected is used until either you change 
it or until your terminal is disconnected from the 
network* 

More than one host path can be available to each 
host from a terminal* If one host path fails, you 
can select an alternate route to the host* 


Selecting a Host 

You can select a host or override a site-defined host 
selection with the following terminal definition com¬ 
mand* 


ct HS=hostname 

ct represents the network control character for your 
terminal* For most asynchronous terminals this is 
ESC or X* 

Each host may be configured with a unique name* 
This name (1 through 7 characters) is indicated by 
hostname* 

For example: 

XHS=ARHN0S 

would select the path with the least traffic to the 
host called ARHNOS (X represents your terminal's 
network control character). 

If you specify the name, your terminal uses the host 
path with the least traffic* 

If you do not know the name you need, the host 
availability display (HAD) can show you what names 
are available* That display is described later in 
this appendix* 

Once you have selected your host, you are ready for 
the next step* 
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Selecting a Specific Host Path 

Use Che follovlag terminal definlCion command to 
select your own host path or to override the site- 
defined host path« 

ct HN=nn 

ct represents the network control character for your 
terminal. For most asynchronous terminals this is 
ESC or %• 

Each access has a unique number, called a node 
number. The host node number (I through 31) Is 
indicated by nn. 

For example: 

xm^2 

would select access 2 (Z represents your terminal^'s 
network control character). 

If you omit the node number, your terminal uses the 
host path the network is using to communicate with 
its supervising host. 

If you do not know the node number you need, the host 
availability display (HAD) can show you what numbers 
are available* That display is described in the 
following subsection. Each node number may have a 
name for its host, provided by your site to help you 
identify the corresponding host system on the HAD* 

Once you have selected the host path, you are ready 
for the next step* 


The software sends you a message that helps you 
decide which step comes next* Turn to the sub¬ 
section appropriate for the next step you must 
perform* 


Controlling the Display of Host Paths 

The host availability display (HAD) (figure J-8) 
lists all host paths your terminal can currently use 
to gain access to the host and all hosts in the net¬ 
work* You can turn display of the HAD on and off or 
request the display with the following terminal def¬ 
inition command* 

ct HO-option 

ct represents the network control character for your 
terminal* For most asynchronous terminals this is 
ESC or Z* 


If the display mode Is N (no), you receive only two 
lines at your terminal (the host status message and 
the prompt message) instead of the full display when 
you disconnect your terminal from a host. 

If you enter HDbY or HD, the full display is issued 
Inmedlately when you disconnect your terminal from 
the host* You then have a choice of hosts and/or 
host paths to which you can request connection. 

If you have a multihost system, typically the HAD 
appears when you first access the network* This 
appearance is controlled by site installation. 



Display 



host status message 

NPU NODES XX TERMINAL NAME= yyyyyy 

CONTROL CHARACTER 

= ct 

HOST 

NODE 

SELECTED/ 

CONNECTED 

STATUS 

host^ 

node^ 

condition*] 

status*! 

host2 

node2 

condition 2 

status2 

hostn 

prompt message 

node^ 

conditionp 

statusp 


Figure J-8* Host Availability Display (Sheet I of 2) 
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Field 


Description 


host status 

Status of a given host 

, which can be one of the following: 

message 





Message 

Meaning 

You Also See: 


HOST CONNECTED 

You are connected 

prompt 



to the host. 

message d or e 


NO HOST SELECTED 

Most is available; 

prompt 



you have not selected 

message b 



a host. 



NO HOST AVAILABLE 

No hosts are avail- 

prompt 



able. 

message a 


HOST UNAVAILABLE 

You have selected 

prompt 



a host that is not 

message a 



up. 



HOST BUSY 

Connection rejected 

prompt 



by host. 

message a 


HOST DISCONNECTED 

Connection to host 

prompt 



terminated. 

message c or e 


HOST AVAILABLE 

You have selected 

prompt 



host that is up. 

message c 1 


NO HOST CONNECTED 

You are not connected 

prompt 



to a host. 

message c 

ct 

Networlc control character currently defined for 

your terminal. 

XX 

The number of the host 

node you are connected to. 

yyyyyy 

The terminal number of 

your terminal. 


host^i 

The 1- to 7-character 

name of a host; if the network only has 


one host, this can be 

blank. 


node^ 

The host node number used in selecting a path through the network; 


1 < nodei < 31. 



condition^ 

S ** selected, not connected 



C * connected, not selected 



SC * selected and connected 



SA « selected, attempting connection 


status^ 

Either AVAILABLE or NOT AVAILABLE; a host is only available when 


it is connected to the 

network. 


prompt 

Action to take In response to a host status message, which can be 

message 

one of the following: 




prompt message a: 

ENTER ct HD TO SEE HOST STATUS 


prompt message b: 

ENTER ct HN=nn TO SELECT 

HOST 


prompt message c: 

ENTER INPUT TO CONNECT TO 

HOST 


prompt message d: 

READY FOR INPUT 



prompt message e: 

TERMINAL DISABLED BY NOP 



prompt message f: 

INPUT DISCARDED 



Figure J-8. Host Availability Display (Sheet 2 oF 2) 
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STEP 6 - CONNECTING TO THE SELECTED HOST 

Your site personnel niighc have configured your 
terminal so chat It Is automatically connected with 
a host* If so, the network continues to attempt 
connection Indefinitely either until the connection 
Is completed or until you stop It by entering ct 
TM* You can tell the network Is attempting to 
connect you when the HAD shows a SA status for any 
host* If your terminal Is automatically connected 
to a host, you may skip this subsection* If not, 
you will have to ask for the connection to be made* 

You can ask to be connected to the selected host by 
entering a carriage return* If the carriage return 
is not preceded by an empty line, the Information Is 
discarded (unless It Is a valid terminal definition 
command)* 


If your connection Is rejected, you are notified* 
If you select another host path you must make 
another entry to complete a connection* The network 
software physically disconnects dial-up devices If 
you do not attempt connection to a host within 2 
minutes of completing the previous step* 

Once you are connected to a host, you are ready for 
the next step. 


STEP 7 - IDENTIFYING YOURSELF AND YOUR TERMINAL TO 
THE HOST 

The step that Identifies you and your terminal to 
the host system Is called login* Your terminal Is 
Identified to the host system by assigning It a 
family name, a user name, and a password* The host 
can prompt you for each of these things* 

Your site can set up your terminal connection so 
that part or all of your login Is done automati¬ 
cally* If so, you might not see the corresponding 
prompt and you need not enter the Information. 


Your site might also require use of a secure login 
Initiation sequence, prior to login, to ensure that 
you send your user Identification to the correct 
host software* If required, the sequence contains a 
site-selected security character and the sequence 
will be recognized by the system at any time* De¬ 
pending on your terminal type, the secure login 
Initiation sequence Is entered In one of the follow¬ 
ing ways* 

• At an asynchronous terminal (not 2741), 

press the Interactive Interrupt key (BREAK 
or ATTN) and type the character at a 2741 
terminal, press the NL key twice* Then 

enter the ATTN key, the character, and press 
the NL key* 

• At an X*25 terminal, press the interactive 
interrupt key, type the character, and press 
the message transmission key* 

e At a mode 4 terminal, clear the screen, press 
SEND, clear the screen again, type the char¬ 
acter, and press the end-of-block key* 

• At a HASP terminal, type the character and 
press the end-of-line key* 

• At a 2780 or 3780, enter /* and the character 
from the console or a card reader* 

• At a 3270, clear the screen, press the pro¬ 
gram attention 1 key, type the security char¬ 
acter, and press the ENTER key* 

This action momentarily disconnects you from the 
host* You might need to reconnect your terminal to 
the host (If connection Is not automatic)* Now you 
are guaranteed that you are sending your login 
entries to the correct host software* 

Refer to figure J-9 for a sample login from an 
asynchronous terminal* In the example, the terminal 
has not been configured by site personnel for auto¬ 
matic login* Everything you would typically enter 
Is shown In lowercase* 


WELCOME TO THE NOS SOFTWARE SYSTEM. 
COPYRIGHT CONTROL DATA 1978^ 198X. 

85/03/01. 09/51*06. T05A50 

CDC NETWORK OPERATING SYSTEM NOS 2 

FAMILY: 

USER NAME: jrc3069 

PASSWORD: jane 

/T05A50 - APPLICATION; iaf 


Figure J-9* Sample Login from an Asynchronous Terminal 
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Automatic Login 

The fatally name or user name assigned co your cer- 
minal for an automatic login can be: 

• K mandatory value* 

• A default value* 

• A primary value* 

If a mandatory value is assigned, you do not receive 
a prompt and cannot use any other value* 

If a default value is assigned, you are prompted and 
you can either: enter an empty line as a response 
to the system prompt If you vant either Che default 
family or user name to apply, or respond to the 
prompt vlch another value* 

The default family name value assigned to your 
terminal for automatic login can be different from 
the default value used by the host for a family 
name* You can override the login default even when 
you do not know the system default; this procedure 
is described In the following subsection* 

If a primary value Is assigned, you do not receive a 
prompt the first time login occurs while you are 
connected to the host* Subsequent logins (refer to 
Restarting login Identification) do prompt you* You 
can override a primary value for user name by 
entering a different value during an abbreviated 
login* Abbreviated login is described in a later 
subsection* 


Login Dialog 

Login begins when the system displays the following 
lines* 

WELCOME TO THE NOS SOFTWARE SYSTEM. 

COPYRIGHT CONTROL DATA 1978^ 198X. 

Then a line appears with the date, time, and 
terminal name; for example: 

83/12/28. 15.23.58. TERM201 

Next is a line your site supplies that identifies 
the host system used; something similar to: 

CDC NETWORK OPERATING SYSTEM NOS 2 


The next line Is either of the following prompts. 

FAMILY: 

This Indicates that no mandatory or primary 
family name has been assigned to your ter¬ 
minal* Enter the 1- to 7-character name of 
the storage device that contains your per¬ 
manent files and press the carriage return* 
If you want to use the default login family 
name, just press the carriage return after 
the FAMILY prompt appears* You can also 
enter a value of 0 to override a preassigned 
login default family name and use the system 
default family name* If you have no preas¬ 
signed default family name, carriage return 
selects the system default family name* 


USER NAME: 

This indicates that no mandatory or primary 
user name has been assigned co your terminal* 
Enter the user name you were given* The user 
name, which can contain any combination of 
digits, letters, and asterisks, identifies 
you as the terminal operator* 


The next prompt appears only after a USER NAME 
prompt has appeared* This final prompt is either: 


PASSWORD: 

or 

PASSWORD: 

XXXXXXX 


The system attempts to preserve your password"* s 
secrecy* If you have set your terminal at full 

duplex (refer co the NOS Reference Set, Volume 3, 
System Commands), your password will not be displayed 
when you enter it* You will not see what you type 
in* At some terminals, the network overprints 
several characters on a line and asks you to type 

your password on that line, as shown by the second 
PASSWORD prompt* After creating this row of over¬ 
struck characters, Che cursor moves back to the 

first character* 

Enter the password currently associated with your 
user name* If you must enter the user name, you 
also must enter the password* No default exists for 
a password* 
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You oust respond to each prompt within 2 Tuinutes. 
If you take too long to respond, this message Is 
displayed at your terminal. 

TIMEOUT. 

Your terminal Is then disconnected from the host. 

If you enter an unacceptable family name, user name, 
or password, you receive either the following 
message: 

IMPROPER LOGIN, TRY AGAIN- 
FAMILY: 

if no mandatory family name Is assigned to your 
terminal, or: 

IMPROPER LOGIN, TRY AGAIN. 

USER NAME: 

If a mandatory family name Is assigned. Reenter all 
needed login Information, beginning with the 
requested parameter, regardless of when the error 
occurred. 

You must spell each login entry correctly. If you 
make a mistake, such as typing the letter 0 for the 
numeral 0 or the number 1 for the letter 1, your 
login will not be successful. Try again when the 
prompting sequence restarts. 

You are allowed four consecutive chances to complete 
the login procedure. If you make four unsuccessful 
attempts to complete login, this message appears at 
your terminal: 

USER RETRY LIMIT. 

Your terminal Is then disconnected from the host. 
If this happens, check the spelling of all of the 
entries. If you spelled everything correctly, 
contact a site administrator. 

When the family name, user name, and password are 
accepted by the host, you must next connect your 
terminal to an application. If there Is no default 
network application. 


STEP 8 - SELEaiNG A NETWORK APPUCATION 

Your site may be set up so that your terminal Is 
connected to the lAF application automatically. Or 
your site may connect your terminal automatically to 
another application, depending on the Installation. 
If so, you might not see the corresponding prompt. 
If not, you must complete this step yourself. 

You are allowed several chances to make a correct 
entry. However, If you fall to connect successfully 
after four consecutive attempts, your terminal Is 
automatically disconnected from the host. If this 
happens, check the spelling of the name you used. 
If the spelling was correct, contact a site 
administrator. 


Automatic Connection 

Your host may permit you access only to one network 
application, or an application can be connected 


automatically. Your host site can configure your 
connection for either possibility by preassigning an 
automatic connection application name. 

A preassigned automatic application connection can 
be either mandatory or primary for the connection or 
It can be mandatory for the user. If either you or 
your connection has a preassigned mandatory appli¬ 
cation, you are not prompted, you are automatically 
connected to that application, and you cannot use 
any other application. If a mandatory application 
program Is not running in the host, you are logged 
out and disconnected from that host. 

If a primary value is assigned, you are not prompted 
for the Initial connection request after Identifying 
your terminal to the host, and connection to that 
program occurs automatically. If that connection Is 
not successful or If you disconnect from that appli¬ 
cation program, you have a choice of actions; you can 
select another application or disconnect from the 
host. 

To override a primary automatic application connec¬ 
tion on the first attempt to select an application, 
name a different application In an abbreviated Login 
entry (described later In this appendix) following a 
login prompt. 

When a primary value Is assigned, you are prompted 
on subsequent attempts to select an application, 
such as when you are switching applications. When 
you are prompted to enter an application name and 
you want to be connected to your primary applica¬ 
tion, enter an empty line as a response. 


Manual Connection 

This procedure begins when you see the following 
prompting message. 

terminalname - APPLICATION: 

The terminalname variable on this line is the same 
terminal name as the one on the first line of your 
login sequence. If your terminal is automatically 
logged into a network application, you do not 
receive this prompt. 

When you receive the APPLICATION prompt, enter the 
letters and digits that identify the network appli¬ 
cation you want to access; for example, lAF for the 
Interactive Facility. You can access CDC-wrltten 
applications from the following list that are In¬ 
stalled at your site: 

• Remote Batch Facility (enter RBF). 

• Interactive Facility (enter lAF). 

• Transaction Facility (enter TAF). 

• Terminal Verification Facility (enter TVF). 

• Message Control System (enter MCS). 

• PLATO (enter PNt, which stands for the 
PLATO-NAM Interface). 

Other applications, written at your site, might be 
available. 
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You must respond to the prompt within 2 minutes* If 
you take too long to respond, this message is 
displayed at your terminal* 

TIMEOUT, 

Your terminal is then disconnected from the host* 

You must spell your entry correctly* If you make a 
mistake, such as typing the letter 0 for the numeral 
0 or the letter 1 for the number I, you receive the 
following error message: 

ILLEGAL APPLICATION^ TRY AGAIN, 
terminalnatne - APPLICATION: 

The terminal name is indicated by terminalname* You 
can also receive this message if your user name is 
not permitted access to the application you named* 
If you did not spell the name correctly, try again* 
If you did spell the name correctly, disconnect your 
terminal and contact a site administrator* 

If you make four unsuccessful attempts to enter an 
application name, this message appears at your ter¬ 
minal* 

APPLICATION RETRY LIMIT. 

Your terminal is then disconnected from the host* 

This step is complete when the application you re¬ 
quest connects to your terminal* The application 
you asked to use might print an identification line 
next* 

Whether the program sends such a message or not, you 
can use commands recognized by that application* If 
you need to disconnect your terminal from the appli¬ 
cation, the application probably has a command for 
that purpose* If the program has no such command, 
the subsection called Disconnecting from a Host des¬ 
cribes a command you can use* 


To use the site-defined login default family name, 
enter: 

,RLS4525,PASS123,IAF 

To override your site-defined login default family 
name with the host's default family name, enter: 

0,RLS4525,PASS123^IAF 

To use a login default family name and user name 
defined by the site for your terminal, enter; 

^.►/lAF 

To also use a default application name defined by 
the site for your terminal, enter: 

You can supply combined entries in response to the 
FAMILY, USER NAME, and PASSWORD prompts* Although 
you do not need to complete the remaining sequence 
on the same line, you must enter the information in 
the correct order: family name, user name, password, 
and application (if there is no default). For 
example: 

FAMILY: systems 

USER NAME: rls4525^pass123 

terminalname - APPLICATION: iaf 

If you supply a user/password combination that is 
overridden by a mandatory specification, this mes¬ 
sage is displayed* 

VOLUNTEERED USER/PASSUORD IGNORED. 

If you offer an application name that is overridden 
by a preassigned mandatory application, the follow¬ 
ing message is displayed* 

VOLUNTEERED APPLICATION IGNORED. 



ABBREVIATED LOGIN AND APPLICATION CONNEaiON 

You can shorten the standard login and application 
connection procedures by entering all of the re¬ 
quired information at once* For example, in res¬ 
ponse to the FAMILY prompt, you can enter the fol¬ 
lowing information on the same line* 

FAMILY: fam1lyname,username,password^applicat ion 

Separate all entries with a comma* The entries are 
order-dependent* Use a comma to indicate any default 
or unused entries* 

You do not receive any of the remaining login selec¬ 
tion prompts if you use this abbreviated login pro¬ 
cedure, unless you omit a required entry or supply an 
entry that is not recognized* Your password entry is 
not protected by the system when you use an abbrevi¬ 
ated login procedure* 

Here are some examples* To log in and connect to 
the Interactive Facility application IAF with a 
family name of SYSTEMA, a user name ot RLS4525, and 
a password of PASS123, enter; 

SYSTEMA,RLS4525,PASS123,IAF 


SWITCHING TO A DIFFERENT APPLICATION 

Unless you have a mandatory network application 
assigned for your terminal, you can transfer your 
terminal's connection from the current application 
to another application* There are two ways to do 
this, depending on the commands used by the current 
application* 


Direct Switches 

You can switch in one step by entering a switch com¬ 
mand recognized by the current application* The fol¬ 
lowing switch commands are recognized by CDC-wrltten 
network applications: 

Application Command 

RBF IAF 

IAF BYE,application 

MCS LOGIN,application 

For example, if your terminal is connected to RBF, 
you can gain access to IAF by entering the IAF 
command* 
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Do not enter any more input until the application 
acknowledges it has processed your switch command. 
Otherwise* you may lose the input. 


There are three ways to restart login, depending on 
the commands recognized by the current application 
and installation options. 


Indirect Switches 


If your current application does not have a command 
for a direct switch* you must disconnect your ter¬ 
minal from the current application with a command 
recognized by that application. Then you must 
request another application connection from the 
host. The following disconnection commands are 
recognized by CDC-wrItten network applications: 


Program 

R8F 

lAF 

KCS 

TAF 

TVF 


Command 


END 

BYE^ 

END 

EX.LOGT 

END 


For example* you can switch your terminal connection 
from kBF to an application other than lAF by 
entering the END command. You then receive a prompt 
for a new application name. Do not enter any more 
input until the application acknowledges it has 
processed your disconnection command. Otherwise, 
you might lose the input. 


Dialog for Direct and Indirect Switches 

After disconnecting the application* the system in¬ 
dicates that a connection switch is in progress by 
Issuing this message. 

application - CONNECT TINE hh.oun.ss. 

The application that was Just disconnected is in¬ 
dicated by application and the time that passed 
while the terminal was connected to the program is 
indicated by hh.mm.ss. 

If you used a switch command* you receive an iden¬ 
tifying message from your new application* If you 
used a disconnection command* you receive another 
prompt for an application name. 

terminalname - APPLICATION: 

unless the terminal is permitted access to only one 
application. If so* you are disconnected from the 
host* 

If you enter Che name of another application in res¬ 
ponse to the APPLICATION prompt, you are connected 
to that application. 


RESTARTING LOGIN IDENTIFICATION 

There are many reasons why you might want to restart 
login identification and the subsequent application 
connection. Perhaps you have several user names 
available to you, each with permission to use dif¬ 
ferent host resources. Or perhaps someone else Left 
Che terminal connected to an application you do not 
need, and you do not want to use their user name. 


Direct Restarts 

You can restart host identification by entering a 
login command recognized by the current application. 
The following login commands are recognized by CDC- 
wrltten network applications: 

Application Command 


RBF LOGIN 
lAF HELLO 
MCS LOGIN 

For example. If your terminal is connected to lAF* 
you can restart login by entering the HELLO command. 

Do not enter any more input until the application 
acknowledges it has processed your command. Other¬ 
wise* you may lose the input* 


Indirect Restarts 

If your current application does not have a command 
for a direct switch, you must disconnect your ter¬ 
minal from the current program with a command rec¬ 
ognized by chat application. Then you must request 
restart of login from the host. The disconnection 
commands recognized by CDC-written network applica¬ 
tion are described earlier in this section under 
Switching Co a Different Application. 

For example* you can restart your terminal Login from 
RBF by entering the END command. You then receive a 
prompt for a new application name. Do not enter any 
more input until the application acknowledges it has 
processed your disconnection command. Otherwise, you 
might lose the input. 


Secure Login Restarts 

If your site has selected the secure login initiation 
option and defined a security character, the sequence 
may be entered at any time to immediately disconnect 
from Che current application and initiate the user 
login procedure. 

After entering the disconnection command, you receive 
another prompt for an application name: 

terminalname - APPLICATION: 

unless the terminal is permitted access to only one 
application program. If so, you are disconnected 
from the host and can restart Login by reconnecting. 

If you receive the APPLICATION prompt* you use one 
of the following commands to ask the host system to 
restart Login: 

HELLO 

LOGIN 
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DISCONNECTING PROM A HOST 

Tou talght wane to disconnect your terminal from a 
host for several reasons, for example: 

• You want to disconnect from the network 
properly, without leaving behind an Indlca*- 
tlon that something went wrong; disconnecting 
from a host is the first step In disconnect¬ 
ing from a CDC network. 

• You are allowed access to more than one host 
system, and you want to transfer your ter¬ 
minal's connection from the current host to 
another host. 

There are four ways to do this, depending on the 
commands used by the current application. 


Disconnecting with Application Commands 


You can disconnect In one step by entering a host 
disconnection command recognized by the current 
application. The following host disconnection 
coQunands are recognized by CDC-wrltten network 
applications: 


Program 


Command 


RBF LOGOUT or LOGOFF 

lAF BYE or LOGOUT or GOODBYE 

MCS BYE or LOGOUT 


For example. If your terminal Is connected to lAF, 
you can disconnect from the host by entering the BYE 
command. 


Disconnecting with Host Commands 

If your current application does not have a command 
for direct disconnection, you must first disconnect 
your terminal from the current program with a com¬ 
mand recognized by that application. Then you must 
request host disconnection from the host. Applica¬ 
tion disconnection commands are described earlier In 
this section under Switching to a Different Applica¬ 
tion. 

After disconnecting the application, the system in¬ 
dicates that a connection switch Is In progress by 
Issuing this message: 

application CONNECT TIME hh.mm.ss. 

The application that was just disconnected Is Indi¬ 
cated by application and the time chat passed 
while the terminal was connected to the program Is 
indicated by hh.mm.ss. 


The following host. disconnection commands are valid 
responses to the APPLICATION prompt on CDC host 
systems: 

BYE 

LOGOUT 

For example, you can disconnect your terminal from 
RBF by entering the END command. You then receive a 
prompt for a new application name and enter BYE. 


Disconnecting with a Network Software Command 

You normally end a connection with a host by using a 
command to disconnect you from an application and/or 
a command to log out of the host. Events might make 
It Impossible for you to do either. When this 
happens, you can end your termlnal^'s connection to 
the host by entering this terminal definition 
command. 

ct T« 

ct represents the network control character. For 
most asynchronous terminals this is ESC. 

The network responds to your TM command with a new 
host avallabllty display. You can use the TM com¬ 
mand If an application does not respond to your 
entries. 


Reconnecting to a Host or Connecting to a Different Host 

For a single host system, after your terminal Is dis¬ 
connected from the host, this message is printed. 

HOST DISCONNECTED. CONTROL CHARACTER = ct 

ct Is the network control character. This message 
Is followed by the prompting message. 

ENTER INPUT TO CONNECT TO HOST 

You can then attempt another connection to the same 
host by sending any Input you want. If you have a 
multihost system, typically the HAD will be dis¬ 
played between these two messages. To reach a dif¬ 
ferent host, you must complete the procedures for 
Selecting a Host and Connecting to the Selected Host 
described earlier In this appendix. 


Disconnecting from One Host and Connecting to a Different 
Host 


You then receive another prompt for an application 
program name: 

terrainalname - APPLICATION: 


You can disconnect from one host establish a connec¬ 
tion with another host using the single command 

ct HC = hn 


unless the terminal Is permitted access to only one ct is the network control character, and hn is the 

application. If so, you are disconnected from the name of the desired host, 

host anyway. 
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INTERRUPTIONS 

Events can sometimes interrupt your input or output. 
These interruptions fall into two categories. 

• Interruptions for communication with the 
network operator. 

• Temporary suspensions in communication. 


Communicating with the Network Operator 

The term network operator includes any operator who 
has access to the network, including the host oper¬ 
ator. Any network operator can send and receive 
messages that involve you. 


Receiving Messages 

The network operator can send short messages to a 
terminal. The message appears at your terminal in 
this format. 

FROM NOP • . . message text 

These messages can appear at any time a new line of 
output is possible at your terminal. For example, 
the network operator might want to inform all con¬ 
nected terminals that communication is going to be 
suspended intentionally with this message. 

FROM NOP . . . SHUTDOWN IN 5 MIN 


Sending Messages 

You can respond to such messages by entering the 
following terminal definition command. 

ct MS=message 

ct represents the network control character. For 
most asynchronous terminals this is ESC. 

The message text must not exceed 50 graphic charac¬ 
ters. Because the network operator can be located 
at a terminal that does not support many special 
characters, you should avoid characters not in the 
ASCII 63-character subset described in appendix A of 
the NOS Reference Set, Volume 2, Guide to System 
Usage. 

You can also begin dialog with the network operator. 
For example. If you need to use a remote batch 
printer that has been logically disabled, the entry: 

%MS=PLEASE ENABLE LP=H4C555 

causes the message PLEASE ENABLE LP*M4C355 to appear 
at the network operator's terminal, prefixed by the 
terminal name of your terminal. The X character 
represents the network control character for your 
terminal. 


Preventing Messages 

Sometimes it is Important that output to your 
terminal does not include unplanned messages from 
the network operator. You can prevent delivery of 
messages from the network operator by locking them 
out with the following terminal definition command. 

ct LK=option 

ct represents the network control character. For 
most asynchronous terminals this is ESC. 

After you enter this command with the option Y, any 
message to your terminal from the network operator 
is discarded by the network software. Messages are 
discarded until you again allow delivery by using 
the command with the option N. 

Site administrators can configure your terminal so 
that messages are discarded as soon as the terminal 
is connected to the network. A network application 
can also change the LK option in use. 


Suspensions of Communication 

Sometimes, message traffic in the network is so heavy 
that all storage is temporarily used up. Also, a 
host may be too busy to accept data. During these 
times, the network software takes steps that tempor¬ 
arily stop input until enough output has occurred to 
free additional storage. 

Although storage may be low, sometimes the network 
cannot prevent you from entering data. Therefore, 
the network discards each message from your terminal 
and sends this message to your terminal. 

WAIT . . 

When the following message appears, you can reenter 
any information that was previously discarded. 

REPEAT . . 

If your terminal transmits more than one message at 
a time, you must determine which information you 
need to reenter. The application might have 
commands that can help you determine which messages 
it received. 


Communicafton Failures 

Events can occur that: 

• Cause your application to fall. 

• Disconnect your terminal from an application. 

• Disconnect your terminal from the host. 

• Disconnect your terminal from the network. 
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Application Failures 

If an application falls after your terminal Is 
connected, this message Is displayed* 

APPLICATION FAILED. 

application CONNECT TINE hh.mm.ss. 

terraInalname - APPLICATION: 

The length of time your terminal was connected to 
the application Is specified by hh.mm.ss; 
application Is the name of the application; and 
terminalname represents the terminal name the 
network uses to Identify Che terminal. You either 
can select another application or log out. 


Disconnection from an Applicotion and/or a Host 

An application Is Informed of two events that you 
might want to Cake action on. 

• Long periods of device Inactivity. 

• Pending network shutdown. 

The network software Informs an application If more 
than 10 minutes have elapsed without any 
communication between a device at your terminal and 
the application. An application can: 

• Ignore this time Interval. 

• Ask you for continued dialog. 

e Disconnect from your terminal or from the 
device with or without telling you. 

The effect of device Inactivity depends on the 
application with which Che device Is currently 
connected. 

When shutdown of the network is pending, the network 
operator can enter a command that Informs all 
applications of the pending event. Your application 
might take actions that either result In connection 
termination or application failure. It also might 
send you a message to warn you of the event. 

If you receive a message from an application 
Indicating that shutdown Is pending, you should take 
steps Immediately to save all data or files you are 
currently using. Then end connection with both the 
application and the host as soon as possible. 


Disconnection from the Network 

The network informs you that It has lost 
communication with the host software by displaying 
the host status message: 

HOST DISCONNECTED. CONTROL CHARACTER = Ct 

followed by the prompting message: 

ENTER INPUT TO CONNECT TO HOST 

If you have a multihost system, the HAD will be 
displayed between these two messages. 

If you are at a dial-up terminal and you do not 
attempt to connect to the same or a different host 
within 2 minutes, your terminal is disconnected from 
the network. 

If communication between the network and the host 
software resumes, you must connect to the host and 
log In again but you do not need to access the net¬ 
work again (perform dial-up and auto-recognltlon pro¬ 
cedures). These host communication failures occur 
either when the host has been shut down or when hard¬ 
ware falls In the communication path between the net¬ 
work and the host. 

All network software conditions (that Is, parameters 
that may be set with terminal definition commands) 
are retained across host disconnection except for 
transparent, full ASCII, and special edit Input 
modes. Refer to the NOS Reference Set, Volume 3, 
System Commands for a discussion of these commands. 

Failures In the communication path between the net¬ 
work hardware and your terminal are treated by the 
network software as If your terminal had failed* 
These failures can occur because of hardware prob¬ 
lems, or maybe because you entered an Input charac¬ 
ter during output* If you hold the Interactive out¬ 
put Interrupt key down for too long, a communication 
failure can occur. This key is identified In the NOS 
Reference Set, Volume 3, System Commands. 

There are several tests for communication failures* 
If your terminal has a CTS, ON-LINE, or CARRIER in¬ 
dicator, the light goes out when a failure occurs. 
At other terminals. If a failure has occurred, re¬ 
questing the host availability display produces no 
response from the network. 

Batch Input and ouput devices associated with the 
failed console stop running, and batch device con¬ 
nections are ended. The network software does not 
distinguish between dial-up and hardwired terminals 
when processing terminal failures. 

Terminal failures require you to complete new access 
and login procedures to resume communication with the 
network* Terminal failures always cause disconnec¬ 
tion when the terminal Is on a dial-up line. 
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